Query Interface

Description

Merchants can check the order information and status by actively calling this interface,

Request Endpoint

https://apis.5upay.com/foreignpayExchangesettlement/query

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
hmac varchar(500) 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

Sample

{ "merchantId":"896667346", "requestId":"1621307590890", "hmac":"F3tLKrJgvoBsd/WtNA3+I7rLg3xZRaqIbtsiPu+xCjhIkoI7T16+fx1hzbkeP5eIMg 4XLfD4yE+GAbqlZxk9E1SMbB2LSUQzrVslEd4M0nofH1l7eh4eBu6tYRpWxf5AT//+QAm W40/yY+jqxvGculVzkUnIyTzxPTsxOUeSWMwLmrTiwcY90wvlYz+VL9IQWJ42ciWgdWv B5WWr3lkPKaI6WKXXZHlR+wiIYIbCI7lHXSs+01rcAOzn+T3HSjXjjMvYb6VpzSUYxFrRF kJKoeDZ5XnMKwbRyxyVUPKB996aUIwU3qauJoEYbm4Jn3L5Um6oNo8SHtS+sC/nVs E/Yw==" }

>Synchronous Returned Field

Name Description
merchantId Merchant ID
requestId 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.
status PROCESSING
SUCCESS
FAILED
ERROR
serialNumber PayEase system transaction serial number
currency CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD
amount UNIT: Cent，1 Dollar = 100 Cents
remark remark
foexignExchangeResponse Please refer to the table "Response field（foexignExchangeResponse，Return parameter of foreign exchange purchase）"
paymentModeAlias FOREIGN-FOREX-ECITIC-P2P
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"

Response field（foexignExchangeResponse，Return parameter of foreign exchange purchase）

Name Description
amount Unit: Cent，1 Dollar = 100 cents
currency CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD
status INIT
PROCESSING
SUCCESS
FAILED
CANCEL
listprice List price
completeDataTime Completion time of the foreign exchange purchase

Sample

{ "merchantId":"896667346", "requestId":"1621307590890", "serialNumber":"2c998074797a156e01797d7b5b9a0000", "orderCurrency":"USD", "orderAmount":"10000", "remark":"remark", "foreignExchange":{}, "paymentModeAlias":"FOREIGN-FOREX-ECITIC-P2P", "status":"PROCESSING", "hmac":"kAGBnDb3V6KNYAHwzuD3ZtdDvq5UT5/gWT4MeZSfaMIN8XXn5grmi9GzlCr ZaLb7eXDPlXZwmDuE0JXY/OLb1cd/VeIGe4Ilab4sg1v69wlHhUnez2eIIYYFmERv8gRw yfcz+duQYuG4pxTfw55NLDqLlvxaGvl7jaNL3wISYqNpPl3jiKs7WZ2KwMnyk3dbAJK1q7 CNumFUgwGNJXXtp3QbYNhzh0l4BFxnJj8HnEPO5tmamwP0dMBKPyMgUwQPB+qQX pJGk43CPRwfaODpjSGNJyFlc2hlNZMQvOqIz3J0PQSg8myQCAAyIsQpZAN8XCKz7ap H4IBVcs9VPkxqKw== }