Card fund management covers positive and reverse fund transfers for prepaid cards: adding available balance to a card and returning available balance to the merchant's corresponding currency account.
| Operation | Fund direction | Business result |
|---|---|---|
| Card top-up | Merchant currency account -> Card balance | Increases available card balance for later spending |
| Balance return | Card balance -> Merchant currency account | Reduces available card balance and recovers funds |
Card top-up increases the available balance of a specified card. After a top-up succeeds, the card balance increases and can be used in spending scenarios supported by the product.
Funds are transferred from the merchant's corresponding currency account to the card balance.
Before topping up, make sure the issuing funding account has enough available balance. If the account balance is insufficient, the top-up may fail.
Before initiating a card top-up, confirm that:
Card top-up can usually be initiated through the Dashboard. The actual entry point and capabilities depend on the Dashboard display.
Through the Dashboard:
Through the API:
Use the Top-up API to initiate a top-up by specifying the card ID and top-up amount. After the status is updated, the card balance increases accordingly.
After the top-up succeeds, the card's available balance increases. The card details page usually shows:
If the Dashboard displays corresponding activity records, the top-up result is usually reflected in later fund movement records. Actual display depends on page capabilities.
Balance return transfers the current available balance on a specified card back to the merchant's corresponding currency account. After the return succeeds, the card's available balance decreases and the funds are available for redistribution or centralized management.
Funds are transferred from the card balance back to the merchant's corresponding currency account.
Before returning balance, make sure the card has refundable balance. If the available balance is insufficient or the card status does not support balance return, the operation may fail.
Before initiating a balance return, confirm that:
Card balance return can usually be initiated through the Dashboard. The actual entry point and capabilities depend on the Dashboard display.
Through the Dashboard:
Through the API:
Use the Balance return API to initiate the operation by specifying the card ID and return amount. After the status is updated, funds return to the merchant's corresponding currency account.
After the balance return succeeds, the card's available balance decreases and the funds return to the merchant's currency account. The card details page usually shows the updated balance, balance return records, and recent fund movements.