Docs
Feature GuidesBilling

Wallet

Manage your prepaid balance, add funds, configure auto-recharge, and view transaction history.

Who should read this:Administrators

The Wallet page manages your prepaid account balance. Call charges, number fees, and other costs are deducted from your wallet balance. When the balance is low, you can add funds manually or set up auto-recharge to stay funded automatically.

Wallet Overview

The wallet page shows:

ElementDescription
Current BalanceYour available prepaid balance
Last Top-UpDate and amount of the most recent deposit
Auto-Recharge StatusWhether automatic top-up is enabled and its configuration

Adding Funds

  1. Navigate to Billing and select Wallet

    Open Billing from the main menu and click Wallet.

  2. Click Add Funds

    Click the Add Funds button.

  3. Enter the amount

    Specify the amount to add. Select a saved payment method or add a new card.

  4. Confirm the top-up

    Click Confirm. The charge is processed through Stripe and the balance updates immediately.

Adding funds requires Stripe payment processing to be configured. If Stripe keys are not set on the server, the Add Funds button shows a "payment not configured" message instead.

Auto-Recharge

Auto-recharge prevents your balance from running out by automatically topping up when it drops below a threshold.

Configuring Auto-Recharge

  1. Open the Auto-Recharge settings

    On the Wallet page, click Configure Auto-Recharge.

  2. Set the threshold

    Enter the minimum balance that triggers a recharge. For example, if you set the threshold to $50, the system tops up your wallet whenever the balance drops below $50.

  3. Set the recharge amount

    Enter the amount to add each time the threshold is reached. For example, $200.

  4. Save

    Click Save. Auto-recharge runs automatically from this point forward.

Auto-recharge charges your saved payment method without additional confirmation. Make sure the threshold and recharge amount are appropriate for your call volume to avoid unexpected charges.

Transaction History

The transaction history table shows every financial movement on your wallet:

ColumnDescription
DateWhen the transaction occurred
TypeTop-up, call charge, number fee, credit, adjustment
DescriptionDetails about the transaction
AmountPositive for deposits, negative for charges
Balance AfterWallet balance after this transaction

Use the transaction history to:

  • Audit charges against your call logs
  • Verify that top-ups were applied correctly
  • Track credits or adjustments from the provider
  • Reconcile wallet activity with invoices

Idempotent Top-Ups

Each top-up request includes an idempotency key to prevent duplicate charges. If a network issue causes a retry, the system recognizes the duplicate and does not charge your card twice.

Provider Credits

The provider can apply credits or debits to your wallet. These appear in the transaction history with a "Provider Adjustment" type and include a note from the provider explaining the reason.

Related Articles