New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Payment Methods


  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration


  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Stripe
  • PayPal Payment Services
  • Chargebee Pay
    • Getting Started with Chargebee Pay
    • Supported Payment Methods
    • Chargebee Pay Portal
      • Dashboards
      • Transactions
      • Payouts
      • Disputes
      • Notifications
      • Balance Reserves
    • Reporting and Reconciliation
    • Funding the Reserves
    • Fraud and Risk Management
    • Dunning
    • Account Updater
    • Token Migration to Chargebee Pay
    • Payment Pricing Models
    • Chargebee Pay FAQ
  • Adyen
  • Authorize.net
  • Bambora (formerly Beanstream)
  • Bank of America
  • BluePay
  • BlueSnap
  • Braintree
  • Checkout.com
  • CyberSource
  • dLocal
  • EBANX
  • Ecentric
  • Elavon
  • E-xact Direct Integration
  • eWay Rapid
  • Global Payments
  • GoCardless
  • J.P. Morgan Mobility Payment Solutions
  • Metrics Global
  • Mollie
  • Moneris
  • Network Merchants Incorporated (NMI)
  • Nuvei
  • Orbital (Chase Paymentech)
  • Pay.com
  • Paymill
  • Paystack
  • Pin Payments
  • QuickBooks Payments
  • Razorpay
  • Sage Pay
  • Solidgate
  • Tempus
  • Twikey
  • Windcave
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
  • Articles and FAQ

Level 2/3 Data Support


  • Level 2/3 Data Support

Payment Optimization Engine


  • Overview
  • Defaults
  • Advanced Setup
  • Payment Method Display Rules
  • Verification Rules
  • Routing Rules

Dunning


  • Dunning
  • Articles and FAQ

Payment Components


  • Overview
  • Use Cases
  • Troubleshooting

Offline Checkout


  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping


  • Transaction Sync and Invoice Mapping

Fraud Management


  • Fraud Management

Error Handling


  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs


  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Gateway Webhook Logs
  • Retries
  • Articles and FAQ

Others


  • Reach (Merchant of Record)
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  2. Payment Gateways and Configuration
  3. Chargebee Pay
  4. Chargebee Pay Portal
  5. Balance Reserves
  1. Payments
  2. Payment Gateways and Configuration
  3. Chargebee Pay
  4. Chargebee Pay Portal
  5. Balance Reserves

Chargebee Pay is available to pre-qualified Chargebee Billing customers.

Balance Reserve

The Balance Reserve page in the Chargebee Pay portal shows your configured reserve balances and reserve transaction history. Use it to monitor how funds move across your Current Account and reserve accounts, identify shortfalls before they affect payouts or refunds, and drill into individual transactions for details.

Click Balance Reserves in the Chargebee Pay portal sidebar to open the Balance Reserve page.

Understand the balances on this page

The page displays the balance for each account shown below. Accounts that are not configured for your site are hidden.

AccountPurpose
Total Current Account BalanceYour current payout balance — funds available for settlement to your bank account. In the Activity Log, this account appears as Current Account.
Refund ReserveDedicated pool used to process customer refunds. If this balance reaches zero, refund attempts fail until the reserve is topped up.
Chargeback ReserveCovers disputed transaction amounts, chargeback fees, and payment return fees. When this balance is insufficient, the shortfall is deducted from your daily payouts.
Rolling ReserveA percentage of each transaction held temporarily to protect against payment returns or chargebacks. Released automatically after the hold period.
Upfront ReserveA one-time reserve taken upfront to cover refunds, chargebacks, or payment returns. Released back to your Current Account after the configured hold period ends.

Note

Rolling Reserve and Upfront Reserve are visible only when those reserve types are configured for your account.

Each reserve shows its current amount. When a reserve has a pending incoming transfer, a badge with the pending amount (for example, $65.00 Pending) appears next to the balance.

If a reserve balance goes negative, Chargebee may move funds automatically to cover the shortfall. For Chargeback Reserve, Chargebee can pull from your Current Account and, if needed, from other reserves. For Refund Reserve, Chargebee can pull from your Current Account. To add funds yourself, use Add funds to your balance reserve — that flow debits your bank account, not your Current Account.

Open the Balance Reserve page

  1. In the Chargebee Pay portal left sidebar, click Balance Reserves.
  2. The page loads your current balances and defaults to the Activity Log tab.
Chargebee Pay Balance Reserve page from sidenav

Add funds to a reserve

The page header includes an Add funds to your balance reserve link. Use it when a reserve balance is low or negative and you need to top it up.

  1. On the Balance Reserve page, click Add funds to your balance reserve.
  2. Complete the Add Funds flow to transfer funds into your Refund Reserve and/or Chargeback Reserve.
Chargebee Pay Balance Reserve page add funds

For step-by-step instructions, see Funding Your Refund and Chargeback Reserve. You can also start the same Add Funds flow from Payouts.

Sync balances

Balance data on this page reflects the last fetch from the payment processor. If the balances look outdated, you can request a fresh sync.

  1. On the Balance Reserve page, click Sync Balances.
  2. When the sync completes, the balances update and the Updated At timestamp refreshes.
Chargebee Pay Balance Reserve page sync button

Information

Use Sync Balances when you have just added funds or received a settlement and the balances have not yet updated.

Work with the Activity Log

The Activity Log tab lists reserve transactions in reverse-chronological order, defaulting to the current month. Use it to track fund movements across reserve accounts, reconcile reserve balances, and audit individual transactions.

Chargebee Pay Balance Reserve activity logs

Filter the Activity Log

  1. On the Activity Log tab, use the filter bar at the top to narrow results:
    • Time Period — select a preset range or a custom date range. The maximum range is 12 months.
    • Status — filter by Success, Failed, or Pending.
    • Reserve Type — filter by one or more reserve accounts: Current Account, Refund Reserve, Chargeback Reserve, Rolling Reserve, or Upfront Reserve.
    • Category — filter by transaction category such as Payment, Refund, Chargeback, or Top Up. See Transaction categories for the full list.
    • Currency — filter by the transaction currency.
  2. Click Apply Filters to update the list.
  3. To remove all active filters, click Clear Filters.

Search for a transaction

Use the search bar to find a specific transaction by its ID.

  1. On the Activity Log tab, enter a transaction ID in the Search field.
  2. The list filters in real time to show matching entries.
  3. Clear the search field to return to the full list.

Note

Search is scoped to the transactions already loaded in the current view. Apply date and other filters first to narrow the range, then search within those results.

Export the Activity Log

  1. On the Activity Log tab, click Export (.CSV).
  2. The export is created in the background. Track progress and download the CSV from Downloads in the left sidebar.

Information

Export is unavailable when a search query is active or when the Activity Log has no transactions. Clear the search field or adjust your filters before exporting.

View transaction details

Click any row in the Activity Log to open the full transaction details page for that entry.

Understand the Activity Log columns

ColumnWhat it shows
TransactionStatus badge, transaction date and time, and transaction ID.
Reserve TypeThe reserve account affected by this entry (for example, Refund Reserve or Current Account), with a Debit or Credit badge indicating the direction of the fund movement.
CategoryThe category of the transaction. See Transaction categories.
Reference IdThe ID of the source transaction associated with this reserve entry, when applicable.
AmountThe transaction amount. Debits are shown in parentheses (for example, ($50.00)); credits are shown as positive amounts.
FeesAny fees associated with the transaction, where applicable.
Net AmountThe transaction amount after fees.
Reserve BalanceFor top-up transactions, shows how the incoming funds were distributed across reserve accounts.

Transactions affecting multiple reserves

Some transactions—such as a reserve top-up split across the Refund Reserve and the Chargeback Reserve—affect more than one reserve account. These appear as Multiple in the Reserve Type column with a tooltip listing the affected accounts.

Chargebee Pay Balance Reserve multiple reserve type

Debit and credit adjustment entries

When funds move between accounts—for example, from the Current Account into a reserve or from a reserve back into the Current Account—the Activity Log does not show a single combined row.

Information

One adjustment appears as two rows. Each debit or credit adjustment is expanded into a source-account row and a destination-account row. Both rows use the same transaction ID and open the same transaction details page. Use the Debit and Credit badges to tell which way the funds moved.

This helps you see the full fund movement: money leaving one account and arriving in another.

Chargebee Pay Balance Reserve credit and debit legs

Transaction categories

Chargebee Pay Balance Reserve multiple categories
CategoryWhat it means
PaymentA payment transaction that moved funds into or out of a reserve account.
RefundA customer refund debited from the Refund Reserve.
ChargebackFunds debited from the Chargeback Reserve to cover a disputed transaction.
Chargeback CreditFunds credited back to the Chargeback Reserve when a dispute is resolved in your favor.
Payment ReturnA payment return (failed direct debit) that debited a reserve account.
Chargeback FeesFees charged by the payment processor for processing a chargeback.
Payment Return FeesFees charged for processing a payment return.
Refund Reserve AdjustmentAn internal transfer of funds between your Current Account and the Refund Reserve. These adjustments are created by Chargebee.
Chargeback Reserve AdjustmentAn internal transfer of funds involving the Chargeback Reserve—either with your Current Account or with another reserve. These adjustments are created by Chargebee.
Top UpFunds added to one or more reserve accounts via the Add Funds flow.

Was this article helpful?