Top-Up Balances for Cards

POST 
/api/v1/cards/topup

Adding funds to the balance of one or more specified cards. The endpoint requires a list of card IDs and the desired top-up amount for each card. The ability to top up is checked against the total amount required for all specified cards. If the wallet does not have sufficient funds to cover the total top-up amount, the operation will be immediately aborted, and an error message will be returned, indicating insufficient funds.

In cases where top-up is feasible but fails for a specific card in the list (due to reasons such as the bank not responding, an unexpected change in status, etc.), the response for that card will include an error string detailing the failure, allowing for individual handling of such cases.

Request

application/json

Body

required

cards string[]required

A list of unique card identifiers for which the operation is to be performed.

amount Amountrequired

The specified amount for the financial operation. This value will be used to adjust the balance of each card listed.

Responses

200

Successful Response

application/json

Schema

Schema

• Array [
anyOf
• ]

Example (from schema)

[
  {}
]

422

Validation Error

application/json

Schema

Schema

detail object[]
Array [
loc object[]required
Array [
anyOf
MOD1
string
MOD2
integer
]
msg Messagerequired
type Error Typerequired
]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...