Card top-up

Top up (add funds) to a card.

Endpoint

POST /{san}/topup

Path parameters

• san — Unique card identifier in the CinCin system

Request

Content-Type: application/json

Request body

Content-Type: application/json

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

Request parameters

• *amount (decimal, >1) — Amount to add to the card

• *currency (string) — Currency code (must match card currency)

• *request_id (string, 12-36 characters) — Unique identifier for the request

Response

Response body

Response body

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

Response parameters

• type (string) — Operation type

• status (string) — Actual status of the operation

• docid (number) — Tracking document ID

• request_id (string) — Request identifier provided in the request

• topup (object) — Top-up operation details

• topup.san (string) — Unique card identifier in the CinCin system

• topup.amount (decimal) — Amount added to the card

• topup.currency (string) — Currency code