List Price Locking Interface

Description

This interface is used for merchants to confirm the current price information by themselves. Merchants can Lock of List price for 10 minutes by calling this int. Merchants need to pass the "serialNumber" returned by this interface into the "order submit interface" to use the locked price.

Request Addres

https://apis.5upay.com/foreignExchange/listpriceLock

Name Type & Max Description Requirement
merchantId varchar(20) The unique identity of the merchant ID in PayEase system. After the merchant completes Payease system registration, the merchant can log in the merchant backend portal to check M
currency varchar(15) CNY, USD, JPY, EUR, CHF, GBP, CAD, AUD, HKD M
hmac varchar(500) The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to the section "Developers" M

Sample

{ "merchantId": "100000050", "currency": "USD", "hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj07M3a x76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPioxLN8Ras 9J9zkL7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLYDXTULr BY7OQ7cLTczfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsRsGc0pNXZ q+gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSNCevRrAjyyRi4Q==" }

Synchronous Returned Field

Name Description
merchantId Same as the request's parameters
serialNumber The serial number for locking price in PayEase system that used to be passed into the "listPriceToken" of the "order submit interface"
listprice E.g. Exchange CNY for USD, then it would be "listprice":622.190000," which indicates that merchants can exchange 622.19CNY for 100USD
validity Expiration time
effective Effective Time
status SUCCESS
hmac The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to the section "Developers"

Sample

{ "merchantId": "100000050", "serialNumber": "8a7df26c62b870cd0163de49e9222544", "listprice": "640.000000", "validity": "2018-06-08 15:36:15", "effective": "2018-06-08 15:26:15", "status": "SUCCESS", "hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj0 7M3ax76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPi oxLN8Ras9J9zkL7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ ZpgLYDXTULrBY7OQ7cLTczfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDB BV9NsRsGc0pNXZq+gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1 ExXtSNCevRrAjyyRi4Q==" }