Top up a prepaid card
POST/credit-cards/:id/top-ups
Loads a prepaid or benefit card: a transfer from a bank account to the card's account, and a negative carryover launch in the open statement linked to it. The card's available limit is its account's balance. Deleting the launch (DELETE /card-transactions/{id}) deletes the transfer too; it cannot be edited. Requires scope finance/credit_cards with access level write.
Request​
Responses​
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
The top-up launch.
Malformed JSON body, or X-Idempotency-Key empty or longer than 255 characters (reason: invalid_idempotency_key).
Missing / invalid / expired / revoked token.
Token lacks the finance/credit_cards scope or the write access level.
Credit card not found within the tenant.
X-Idempotency-Key reused with a different body.
Schema validation failure; the card is a credit card (reason: card_not_prepaid) or cancelled (reason: card_cancelled); the amount is zero (reason: amount_not_positive); no open statement (reason: no_open_statement); the source account is a card's (reason: funding_account_is_card) or of another company (reason: funding_account_other_company); an impossible date (reason: invalid_date).
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.