锁定牌价接口
功能概述
本接口用于商户自行确认当前牌价信息，商户可通过调用此接口将牌价锁定十分钟，将接口返回的牌价流水号传入网关购汇接口便可使用此次锁定的牌价。
接口地址
https://apis.5upay.com/foreignExchange/listpriceLock
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(20) |
商户编号 |
M |
| currency |
币种 |
varchar(15) |
CNY（人民币）、USD（美元）、JPY（日元）、EUR（欧元）、CHF（瑞士法郎）、GBP（英镑）、CAD（加拿大元）、AUD（澳大利亚元）、HKD（港币） |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId": "100000050",
"currency": "USD",
"hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj07M3a
x76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPioxLN8Ras
9J9zkL7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLYDXTULr
BY7OQ7cLTczfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsRsGc0pNXZ
q+gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSNCevRrAjyyRi4Q=="
}
]]>
锁定牌价同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| serialNumber |
锁定牌价流水号 |
首信易锁定牌价流水号，将此参数传入购汇下单接口的listPriceToken中 |
| listprice |
牌价 |
例：CNY 换 USD"listprice":622.190000,"意味 622.19CNY 可以换 100USD |
| validity |
失效时间 |
失效时间 |
| effective |
生效时间 |
生效时间 |
| status |
查询状态 |
SUCCESS 成功 |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
示例
<![CDATA[
{
"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=="
}
]]>