Wallet & Billing

Your wallet is the prepaid balance used to pay for API requests. All charges are deducted from your wallet balance automatically.

Understanding Your Wallet

Balance Overview

Current Balance

• Displayed in USD
• Updates in real-time as you make API calls
• Minimum balance to create API keys: $5.00

Status Indicators:

• 🟢 Healthy: Balance above low threshold (default: $10)
• 🟡 Low Balance: Below threshold, needs attention
• 🔴 Frozen: Balance at $0, API calls blocked

Low Balance Alert

Set a custom threshold to receive warnings before running out of funds:

1. Go to Organization Settings
2. Adjust Low Balance Threshold
3. Default is $10, can set any amount
4. Receive email when balance drops below this level

Depositing Funds

How to Deposit

1. Click "Add Funds" button on Wallet page
2. Choose a quick amount ($10, $25, $50, $100, $200, $500) or enter a custom amount
3. Minimum deposit: $5.00 | Maximum: $10,000
4. Select your preferred payment method:
   • Credit/Debit Card (Powered by Stripe)
   • Cryptocurrency (Powered by NOWPayments)
5. Complete the payment
6. Balance automatically updates when confirmed

Payment Methods

Credit/Debit Card (Stripe)

Fast and Simple:

• Pay with Visa, Mastercard, American Express
• Instant confirmation
• Secure checkout via Stripe

Process:

1. Select "Card" payment method
2. Click "Continue to Checkout"
3. Enter card details on Stripe's secure page
4. Payment processed instantly
5. Balance updated immediately

Cryptocurrency (NOWPayments)

Recommended Cryptocurrencies (Fastest):

• USDT (TRC20) - Lowest fees, ~5 min confirmation
• USDT (ERC20) - Higher fees, ~15 min confirmation

Other Options:

• Bitcoin (BTC)
• Ethereum (ETH)
• And 100+ other cryptocurrencies

Process:

1. Select "Crypto" payment method
2. Click "Continue to Payment"
3. Select your preferred cryptocurrency
4. Transfer funds to provided address
5. Wait for blockchain confirmation (5-30 minutes)

Payment Process

Step 1: Create Invoice

• Enter amount in USD
• System creates payment invoice
• Card payments: 24 hours to complete
• Crypto payments: 2 hours to complete

Step 2: Make Payment

• Card: Enter details on Stripe's secure checkout
• Crypto: Receive wallet address and send exact amount
• ⚠️ Important: For crypto, send ONLY the specified cryptocurrency

Step 3: Confirmation

• Card: Instant confirmation
• Crypto: Waiting for blockchain confirmations (varies by currency)
• Progress indicator shows confirmation status

Step 4: Credit Applied

• Payment confirmed
• Wallet balance updated
• API budget synced with LiteLLM (automatic)
• Transaction record created
• If wallet was frozen, automatically unfrozen

Payment Security

All payments are secured with:

• ✅ PCI Compliance: Card payments via Stripe (PCI-DSS Level 1)
• ✅ Signature Verification: HMAC-SHA512 validation for crypto callbacks
• ✅ Amount Verification: Must match requested amount (±1%)
• ✅ Idempotency: Prevents duplicate processing
• ✅ Encrypted Connections: All data transmitted over HTTPS

Transaction History

View all wallet activity with detailed records.

Transaction Types

Deposits (Green)

• Cryptocurrency payments received
• Shows original amount in crypto + USD value
• Blockchain transaction ID for reference
• Status: Pending → Confirmed

Usage Deductions (Red)

• API request charges
• Deducted after each successful request
• Shows model used and token count
• Links to request log for details

Refunds (Green)

• Credits issued by admin
• Includes reason in description
• Adds to available balance

Adjustments (Yellow)

• Manual balance changes by admin
• Can be positive or negative
• Includes admin notes

Viewing Transactions

Transaction Record Details:

• Type: DEPOSIT, USAGE_DEDUCTION, REFUND, ADJUSTMENT
• Amount: USD value with + or - prefix
• Balance After: Your balance after this transaction
• Timestamp: Exact date and time
• Description: Human-readable explanation
• Metadata: Additional technical details (expandable)

Pagination:

• 20 transactions per page
• Click "Load More" for older transactions
• Most recent transactions shown first

Spending Analytics

Current Period Stats

This Month

• Total spending in current calendar month
• Resets on 1st of each month
• Useful for budget planning

Last 30 Days

• Rolling 30-day window
• More accurate for monthly budget tracking
• Smooths out month-boundary effects

Average Daily Burn Rate

• Your average daily spending
• Calculated from last 30 days
• Helps predict when you'll need to top up

Estimated Days Remaining

• Days until balance reaches $0
• Based on current burn rate
• Updates daily
• Formula: Current Balance / Average Daily Spend

Cost Optimization Tips

Monitor Your Spending:

1. Check Request Logs to see per-request costs
2. Identify expensive models being used
3. Consider cheaper alternatives for simpler tasks

Use Model Tiers:

• GPT-3.5 Turbo: Fast and cheap for simple tasks
• GPT-4: More expensive, use for complex reasoning
• Claude: Good balance of capability and cost

Set API Key Limits:

• Prevent runaway costs with monthly limits
• Set different limits for dev vs production keys
• Receive alerts when approaching limits

Billing Model

Prepaid System

Aize Platform uses a prepaid billing model:

1. Deposit First: Add funds to wallet before usage
2. Pay Per Use: Charged only for actual API calls
3. Immediate Deduction: Cost deducted after each request
4. No Minimums: Use as little or as much as needed
5. No Expiration: Funds never expire

How Costs Are Calculated

Each API request cost includes:

Total Cost = (Base Provider Cost × Markup) + Fixed Fee

Example:

• Provider cost (OpenAI): $0.10
• Markup (25%): $0.025
• Fixed fee: $0.01
• Your cost: $0.135

Costs vary by:

• Model: GPT-4 > GPT-3.5 > others
• Tokens: More tokens = higher cost
• Input vs Output: Output tokens typically cost more

Transparent Pricing

View exact costs for each request:

1. Go to Request Logs
2. See breakdown:
   • Provider cost (what we pay)
   • Customer cost (what you pay)
   • Our markup (transparent)
   • Input/output token breakdown

Wallet Status & Freezing

When Wallets Get Frozen

Automatic Freezing:

• Balance reaches $0.00
• System immediately freezes organization
• All API calls blocked with 402 Payment Required
• Cannot create new API keys

Manual Freezing (Admin action):

• Compliance violations
• Payment disputes
• Account under review

Effects of Frozen Wallet

When frozen:

• ❌ API calls blocked
• ❌ Cannot create API keys
• ✅ Can view dashboard
• ✅ Can view analytics/logs
• ✅ Can make deposits

Unfreezing Process

Automatic Unfreeze:

1. Make a deposit (minimum $10)
2. Wait for payment confirmation
3. Wallet automatically unfrozen
4. API access restored immediately
5. Email notification sent

Manual Unfreeze (if admin-frozen):

• Contact support
• Resolve underlying issue
• Admin manually unfreezes account

FAQs

How long do deposits take?

Card Payments (Stripe):

• Instant confirmation
• Balance updated immediately

Cryptocurrency Payments:

• USDT (TRC20): 5-15 minutes
• USDT (ERC20): 10-20 minutes
• Bitcoin: 30-60 minutes
• Ethereum: 10-20 minutes

What if I sent the wrong amount (crypto)?

Underpayment (< 99% of requested):

• Payment rejected
• Funds returned to sender (minus blockchain fees)
• Create new invoice with correct amount

Overpayment (> 101% of requested):

• Excess credited to your wallet
• Receive full amount sent

Can I get a refund?

Card payments:

• Contact support within 7 days
• Refunds processed through Stripe
• May take 5-10 business days to appear

Crypto payments:

• Deposits are final (blockchain transactions irreversible)
• Unused balance remains in wallet indefinitely
• Can use for future API calls

Special circumstances:

• Contact support for exceptional cases
• Admin can issue manual refunds if approved
• Refund appears as REFUND transaction

What happens to remaining balance?

• Funds never expire
• Available for future use
• If closing account, contact support
• May be eligible for withdrawal (case-by-case)

Is my payment information secure?

Yes:

• ✅ No card info stored on our servers (processed by Stripe)
• ✅ Stripe is PCI-DSS Level 1 certified
• ✅ Crypto payments processed by NOWPayments
• ✅ HMAC signature verification on all callbacks
• ✅ All connections encrypted with TLS 1.3

Getting Help

Payment Issues:

1. Check blockchain explorer for transaction status
2. Verify correct address and amount sent
3. Wait full confirmation time (varies by coin)
4. Contact support if payment confirmed but not credited

Wallet Questions:

• Email: [email protected]
• Include:
  • Organization ID
  • Transaction ID (if applicable)
  • Screenshots if helpful

Next Steps

• Create API keys after depositing
• Monitor spending in Request Logs
• Set up team member access
• View detailed analytics