Skip to main content
This guide explains how to move funds between your organization balance and a card balance (when your program supports stored value).
For exact request parameters and response shapes, use the Cards API reference.

​
Top up a card

Top ups move funds from your organization balance → to the card balance. What your user should experience:
  • You confirm the amount
  • You show the updated card balance after success
  • You show a clear “insufficient funds” message when funding fails
A top up fails when your organization balance cannot cover the requested amount.

​
Withdraw funds from a card

Withdrawals move funds from the card balance → back to your organization balance. What your user should experience:
  • You confirm the amount
  • You show the updated balances after success
  • You show a clear “insufficient card balance” message when it fails

​
Checking the Card Balance

You should display card and organization balances in your UI so support teams can reconcile funding quickly.

​
FAQ

Is there a minimum or maximum top-up amount? For top-ups via the API, there is a minimum amount requirement of 1.01 USD. Are top-ups and withdrawals instant? Top-ups and withdrawals via the API are processed immediately.