Card Top-Up

Adds funds to an existing card from user's account.

Endpoint: POST /{san}/topup

Path Parameters:

• san - Secure Account Number (card identifier)

Content-Type: application/json

Request Body:

{
  "amount": 100.00,
  "currency": "USD",
  "request_id": "496708ff-cf9f-4667-a8ab-649fc2cd9094"
}

Request Parameters:

Field	Type	Required	Constraints	Description
amount	Decimal	Yes	> 1	Amount to add to the card
currency	String	Yes	USD, EUR	Currency code (must match card currency)
request_id	String	Yes	12-36 characters	Unique request identifier

Response:

{
  "type": "TOPUP",
  "status": "INPROCESS",
  "docid": 123456,
  "request_id": "496708ff-cf9f-4667-a8ab-649fc2cd9094",
  "topup": {
    "san": "90ce74952717804177",
    "amount": 100.00,
    "currency": "USD"
  }
}

Response Parameters:

Field	Type	Description
type	String	Operation type (TOPUP)
status	String	Current status of the operation (INPROCESS, EXECUTED, DECLINED)
docid	Number	Document ID for tracking the operation
request_id	String	The request ID provided in the request
topup	Object	Top-up operation details
topup.amount	Decimal	Amount added to the card
topup.currency	String	Currency code (USD, EUR, etc.)