In short. You are told the moment a card goes below zero
(
card.negative_balance). You have 3 days
to fund the card yourself. After that, the card is funded back to $0.00 from your business
wallet, once a day until it is clear, provided your wallet covers the whole amount.Why a card goes below zero
A card cannot spend more than it holds: a purchase larger than the balance is declined. A balance goes negative when money is taken from the card after the purchase was approved, or without an approval at all:
The cardholder made the payment on a card issued to your business, so the amount is owed by your
business.
A double debit is disputed
If the statement shows the same purchase settled twice, contact support with the card ID and both transactions. We raise the duplicate with the issuer. If it is reversed, the amount comes back to the card and pays off what it owes. A dispute takes time, so fund the card in the meantime if the cardholder needs to keep using it.How you are told
The event normally arrives within minutes of the charge that caused it.
GET /cards/{cardId} returns a negative balance while the card owes
money.
While a card is below zero it has nothing to spend, so new purchases are declined until it is
settled. Settle promptly, or freeze the card
until you do.
Settling it yourself: fund the card
Fund the card withPOST /cards/{cardId}/fund. The funding pays off
what the card owes first; whatever is left becomes its spendable balance.
Example: a double debit. A card holds $50.00. A hotel settles a $42.00 purchase, leaving
$8.00, and then presents the same $42.00 a second time. The card is now at −$34.00.
1
The card goes below zero
2
You fund the card with $40.00
Your wallet is charged as for any funding. $34.00 pays what the card owed and $6.00 is
spendable.
3
The card is back above zero
You receive
card.funded, then:If you do not: automatic settlement from your wallet
A card that is still below zero 3 days aftercard.negative_balance is settled for you. Once a
day (at 09:20 UTC):
- The card’s balance is read live. A card you have already brought back to zero is left alone.
- If your business wallet covers the whole amount, the card is funded with exactly what it owes, so it ends at $0.00. No funding fee is charged on this funding.
- You receive
card.funded, thencard.negative_balance_settled.
Before you delete a card
A card that owes money cannot be closed. Settle it first: fund it, or let the automatic settlement run, and wait forcard.negative_balance_settled. Then delete it with
DELETE /cards/{cardId}.
Checklist for your integration
- Handle
card.negative_balanceandcard.negative_balance_settled. - On
card.negative_balance, fund the card (at leastamount, and at least $1.00) or freeze it until you can. - Keep your wallet funded: the automatic settlement takes only the whole amount, never part of it.
- Show the cardholder their real balance, including when it is negative.

