active, you can top it up from your cards_visa or cards_mastercard balance, as long as its card product is reloadable (is_reloadable: true).
Request
Response
The call returns202: the top-up is accepted and applied asynchronously.
How it works
total_charged(the amount plus the reload fee of your plan) is debited from your ops balance —cards_mastercardorcards_visa, depending on the card’s brand.- The card is credited with
amount. - You receive a
card.topup.completedwebhook once the card is credited. - If the top-up cannot be applied, you receive
card.topup.failedandtotal_chargedis refunded to the samecards_visaorcards_mastercardbalance.
Fees
The fee depends on your plan: from $1 + 1.9% on Découverte to $1 + 1.25% on Premium. It is returned on each product byGET /cards/products, in fees.reload_fee, made of a fixed part and a percent of the amount.
Example on Découverte ($1 + 1.9%): a 100 USD top-up costs 102.90 USD, a 40 USD top-up costs 41.76 USD.
On Découverte, the amount loaded on cards (initial loads and top-ups) is limited to 5,000 USD per calendar month. Beyond it, the top-up returns
403 PLAN_LIMIT_REACHED with the remaining amount and the reset date (resets_at).Requirements
- Card must be
active(not frozen, pending, cancelled or failed) - Card product must be reloadable
- Amount must be between the product’s
min_reloadandmax_reload - The card balance after the top-up must not exceed the product’s
max_balance - Your
cards_visaorcards_mastercardbalance must covertotal_charged