Merchants make pricing queries through this interface and receive the results returned by PayEase
https://apis.5upay.com/listprice/obtain
| Name | Type & Max | Description | Requirement |
|---|---|---|---|
| merchantId | varchar(9) | The unique identity of the merchant ID in Payease system. After the merchant completes Payease system registration, the merchant can log in the merchant background to check | M |
| requestId | varchar(50) | The requestId is an ID generated by the merchant. This ID is unique for each merchant and can be used for ensuring the uniqueness of the request；For paid or cancelled orders in the PayEase payment system, the merchant side cannot submit them again. | M |
| sourceCurrency | varchar(3) | CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD | M |
| targetCurrency | varchar(3) | Currently CNY is supported | M |
| channel | Fixed value | Default value is empty | O |
| dealtSide | Fixed value | BUY (Bank's price of purchasing spot exchange) | M |
| SELL (Bank's price of selling spot exchange) | |||
| hmac | - | The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" | M |
The above parameter values cannot contain the following special characters:
’”&<>()
| Name | Description |
|---|---|
| merchantId | The unique identity of the merchant ID in Payease system. After the merchant completes Payease system registration, the merchant can log in the merchant background to check |
| sourceCurrency | CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD |
| targetCurrency | CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD |
| listprice | E.g. exchange CNY for USD, then "listprice":622.190000", which means merchant can change 622.19 CNY for 100 USD |
| listpriceDateTime | E.g. 2020-08-05 00:00:00 |
| tradeUnit | The trade unit |
| status | SUCCESS |
| FAILED | |
| ERROR | |
| resMessage | Request status message |
| hmac | The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" |