# Bank Card Top-up

### POST Bank Card Top-up

POST /api/mastercard/masterCardTopup.html

Bank card top-up: Top-up status: 1 - Success, 2 - Failure, 3 - Processing

> Request Body

```
```

```json
{
  "amount": 100,
  "cardId": "card123456",
  "cardNo": "1234567890",
  "currency": "EUR",
  "orderNo": "ORDER1234567890",
  "payAccountNum": "PAY1234567890",
  "randomStr": "abcdef1234567890"
}
```

#### Request Parameters

| Name          | Type    | Required | Base64 Encoding | Field Name      | Description                                                                              |
| ------------- | ------- | -------- | --------------- | --------------- | ---------------------------------------------------------------------------------------- |
| cardId        | string  | false    | none            | Card token      | Either cardId or cardNo must be provided                                                 |
| cardNo        | string  | false    | none            | Card number     | Either cardId or cardNo must be provided                                                 |
| orderNo       | string  | true     | none            | Order number    | Top-up order number, alphanumeric, unique (between 10 and 32 characters)                 |
| payAccountNum | any     | false    | none            | Payment account | IBAN (default not provided)                                                              |
| amount        | integer | true     | none            | Top-up amount   | Top-up amount, e.g., 1 = 0.01EUR, 1 = 0.000001USDT                                       |
| currency      | string  | true     | none            | Top-up currency | Fixed value: EUR/USDT Note: Different currencies have different precision for the amount |
| randomStr     | string  | true     | none            | Randomstr       | A random string of 32 characters                                                         |

> Example Response
>
> 200 Response

```
```

```json
{
    "topupStatus":1,
    "errMsg":"Success",
    "amount":10000,
    "currency":"EUR",
    "fee":100
}
```

#### Response Fields

| Name        | Type    | Required | Constraints | Description                                                                              |
| ----------- | ------- | -------- | ----------- | ---------------------------------------------------------------------------------------- |
| topupStatus | integer | true     | none        | Top-up status: 1 - Success, 2 - Failure, 3 - Processing                                  |
| errMsg      | string  | true     | none        | Status description                                                                       |
| currency    | string  | true     | none        | Fixed value: EUR/USDT Note: Different currencies have different precision for the amount |
| amount      | integer | true     | none        | Top-up amount,e.g:1 = 0.01EUR, 1 = 0.000001USDT                                          |
| fee         | integer | true     | none        | fee,e.g: 1 = 0.01EUR, 1 = 0.000001USDT                                                   |