> For the complete documentation index, see [llms.txt](https://docs.cardspro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cardspro.com/api/cards/card-top-up.md).

# 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:**

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

**Request Parameters:**

<table><thead><tr><th width="138.66668701171875">Field</th><th width="120.6666259765625">Type</th><th width="114.3333740234375">Required</th><th width="133">Constraints</th><th>Description</th></tr></thead><tbody><tr><td><code>amount</code></td><td>Decimal</td><td>Yes</td><td>> 1</td><td>Amount to add to the card</td></tr><tr><td><code>currency</code></td><td>String</td><td>Yes</td><td>USD, EUR</td><td>Currency code (must match card currency)</td></tr><tr><td><code>request_id</code></td><td>String</td><td>Yes</td><td>12-36 characters</td><td>Unique request identifier</td></tr></tbody></table>

**Response:**

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

**Response Parameters:**

<table><thead><tr><th width="184.22216796875">Field</th><th width="143.4443359375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>String</td><td>Operation type (TOPUP)</td></tr><tr><td><code>status</code></td><td>String</td><td><p>Current status of the operation </p><p>(INPROCESS, EXECUTED, DECLINED)</p></td></tr><tr><td><code>docid</code></td><td>Number</td><td>Document ID for tracking the operation</td></tr><tr><td><code>request_id</code></td><td>String</td><td>The request ID provided in the request</td></tr><tr><td><code>topup</code></td><td>Object</td><td>Top-up operation details</td></tr><tr><td><code>topup.amount</code></td><td>Decimal</td><td>Amount added to the card</td></tr><tr><td><code>topup.currency</code></td><td>String</td><td>Currency code (USD, EUR, etc.)</td></tr></tbody></table>