# Query Exchange Rate API (Common)

## :white\_check\_mark: **Query Exchange Rate API**

:ballot\_box\_with\_check: **Request Message Parameters**

| **Params Name** | **Description** | **Required** | **Notes**             |
| --------------- | --------------- | ------------ | --------------------- |
| action          | Action name     | Y            | EX\_RATE\_QUERY       |
| version         | Version number  | Y            | 1.0                   |
| merchant\_id    | Merchant ID     | Y            |                       |
| data            | encrypted data  | Y            | Refer to "Data" below |
| md5             | Message digest  | Y            |                       |

#### :white\_check\_mark: Data**(JSON Data, to be encrypted):**

| Params Name |  Description  | Required |              Notes             |
| :---------: | :-----------: | :------: | :----------------------------: |
|  fee\_type  | Currency type |     Y    | According to ISO-4217 standard |

:ballot\_box\_with\_check: **Response Message Parameters**

| **Params Name** | **Description**  | **Required** | **Notes**             |
| --------------- | ---------------- | ------------ | --------------------- |
| rsp\_code       | Response code    | Y            | Refer to Appendix B   |
| rsp\_msg        | Response message | Y            |                       |
| data            | encrypted data   | Y            | Refer to "Data" below |
| md5             | Message digest   | Y            |                       |

#### :white\_check\_mark: Data**(JSON Data, to be encrypted):**

| Params Name |      Description     | Required |                       Notes                       |
| :---------: | :------------------: | :------: | :-----------------------------------------------: |
|   feeType   |     Currency type    |     Y    |           According to ISO-4217 standard          |
|     rate    | Exchange rate to CNY |     Y    | If rate = 6.5，number is 650000000, ten power of 8 |
|   rateTime  |   rate setting time  |     Y    |                 string, timestamp                 |