Skip to main content
Once a card is 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 returns 202: the top-up is accepted and applied asynchronously.

How it works

  1. total_charged (the amount plus the reload fee of your plan) is debited from your ops balance — cards_mastercard or cards_visa, depending on the card’s brand.
  2. The card is credited with amount.
  3. You receive a card.topup.completed webhook once the card is credited.
  4. If the top-up cannot be applied, you receive card.topup.failed and total_charged is refunded to the same cards_visa or cards_mastercard balance.

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 by GET /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_reload and max_reload
  • The card balance after the top-up must not exceed the product’s max_balance
  • Your cards_visa or cards_mastercard balance must cover total_charged

Common errors

Check your cards_visa and cards_mastercard balances with GET /balance before topping up to avoid INSUFFICIENT_BALANCE errors.