# Topup Card

This API is used to top up a account card.There may be a delay in updating the card balance after top up the card.

* **Path: /api/v1/card/topup**
* **Method: POST**
* **Content-Type**

  application/json
* **Headers**

| Key           | Type   | Required | Comments             |
| ------------- | ------ | -------- | -------------------- |
| authorization | string | YES      | Authorization Header |

* **Body**

| Key             | Type   | Required | Comments                                                                                                           |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------ |
| api\_key        | string | YES      | api key                                                                                                            |
| request\_id     | string | YES      | Unique id; the shortest is 20 characters, the longest is 64 characters                                             |
| timestamp       | string | YES      | 13-digit; Valid for plus or minus 30 seconds                                                                       |
| username        | string | YES      | Unique username of the account.                                                                                    |
| kit\_number     | string | YES      | Show on card                                                                                                       |
| amount          | string | YES      | amount (two decimal places)                                                                                        |
| transaction\_id | string | YES      | Unique transaction id; the shortest is 20 characters, the longest is 64 characters                                 |
| fund\_source    | string | YES      | Source of fund: Employment Income、Investment Income、Business Income、Savings、Loans、Sales of Investment、Gifts、Others |
| sign            | string | YES      | sign: MD5(api\_key+username+timestamp+secret+request\_id+amount)lowercase hex                                      |

* **Example**

  ```js
  {
    api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
    request_id: '114da8ed89ee4940b2dedfbc808d58ae',
    timestamp: '1682074874405',
    username: 'lili111',
    kit_number: '111111',
    amount: '10.22',
    transaction_id: '16820748744051682074874405',
    sign: '7936e4bf581a6336271798a4d396322e'
  }
  ```

  **signature example**:MD5(fd01a53d7834b06c080cd1024ae9c60alili111168207487440516388ce4331b35e8e0d32777ba57d7d9114da8ed89ee4940b2dedfbc808d58ae10.22)
* **Response**

| Key  | Type   | Comments         |
| ---- | ------ | ---------------- |
| code | number | Response code    |
| msg  | string | Response message |

* **Example**

  ```js
  {
    "code": 10200,
    "msg": "ok"
  }
  ```
