Load a prepaid card
POST/api/partner/cards/:id/prepaid/loads
Moves money from one of the owner's main accounts to the prepaid card.
The answer is 201 with the load. Its status is usually SUBMITTED: the bank accepted the payment
and books it within a few seconds. Ask for the load with
GET /cards/{id}/prepaid/loads/{loadId} until status is SUCCESS or FAILED.
UNCONFIRMED means the bank did not answer: the money may or may not have moved. PayNovus checks it.
Do not load the card again until the load is finished - a new load of the card is refused (409) while
one is not finished.
idempotencyKey is required: generate a new one for each load. A request with a key you already used is
refused with 409 and code LOAD_ALREADY_EXISTS, and nothing is paid again. When that load is of the same
card, its loadId is in the answer. Keys are yours alone: a key used by someone else does not conflict.
Request
Responses
- 201
- 400
- 401
- 404
- 409
- 422
- 502
The load was made
The amount is not valid, or the source account is not one of the card owner's accounts
Unauthorized — missing or invalid JWT
Not found
You already used the idempotencyKey (code: LOAD_ALREADY_EXISTS), a load of the card is not finished
yet, or the card can not be loaded in its current state. Nothing was paid.
There is not enough money in the source account. Nothing was paid.
The payment could not be made right now. Nothing was paid; try again.