牌价查询接口
功能描述
商户通过向汇元通指定的 URL 发送牌价查询请求，并接收汇元通返回的结果数据。
接口地址
https://apis.geoswift.com/overseas/listPrice/bid
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在汇元通系统的唯一id，可在商户后台查看 |
M |
| sourceCurrency |
源币种 |
固定值 |
EUR 欧元 |
M |
| GBP 英镑 |
| CAD 加元 |
| SGD 新加坡元 |
| AUD 澳元 |
| JPY日元 |
| USD美元 |
| HKD港币 |
| businessType |
业务类型 |
固定值 |
1 杰易汇 |
M |
| partnerId |
服务商 id |
varchar(9) |
二级商户上属服务商商户在汇元通系统 的唯一身份标识（如果发起商户自身即为 主商户此项可不传） |
C |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
以上参数值中不能包含以下特殊字符’”&<>()
示例
<![CDATA[
{
"merchantId": "890000595",
"sourceCurrency": "USD",
"businessType": "1",
"hmac": "jotr2gDb/Ih33gFNYaHsRkUZvKqGX8oKYo8K667kcnRg6CKSE1wwVUv8k1b/jeegikY2FZn1
VAgyuLyj3smGgMlsHW+cbf7qNyPM+Xpq267Me5rKai271lhKHca4eBOztd0RJxrfBYjbLoyN5 Cqpg/Rw0
1z9w4q33j1WqcwGKEkpMKxTKlYukW65qvJtUoKrFtYUd1Z+PtloPPNUdV2L5+IfL yuJBdYvRGFI2Ylq3o
jt0wuAcWCmnkig7GmHGaYbUK6eBUvAp/YPwyguy727yqqZqs5zgGzk ELqFqNsYjpz4Z/Pib2lzo9c/vWKv
WnzgEwPSm/C/JWZ9RDvJ8svl5w=="
}
]]>
返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| sourceCurrency |
源币种 |
同请求参数 |
| targetCurrency |
目标币种 |
CNY 人民币 |
| listprice |
牌价 |
牌价/货币交易单位=汇率(1元外币可以兑换的人民币金额) |
| tradeUnit |
货币交易单位 |
货币交易单位 |
| listpriceDateTime |
牌价时间 |
例：2020-08-05 00:00:00 |
| status |
请求状态 |
SUCCESS 成功 |
| ERROR 错误 |
| resMessage |
请求状态信息 |
请求状态信息 |
| partnerId |
服务商 id |
同请求参数 |
| hmac |
参数签名 |
汇元通生成的参数签名结果，验签过程请参考解密流程 |
示例
<![CDATA[
{
"hmac": "a3C+SURbyjwij+AfV9Ujf2gKAZktHsZMxqvAWUjhBsa0VDlaP2gJgpujaIZZhYnxWEBSsYE
OEQvmXGytpbrFDzkYbhRh/9lib2Z8M1g4rukuiW08xoYCiQE22k1F948VHloTPgrMncN+LbfgXBmix+1
GMZVF+jBu69qc+98R0/qPQpIs5E+mRUoDwzb8MY1Akh3HSH43igOlxWpLSpj7/ChHaU2j4UDcu32QNeS
s7OmooxHOdtkmq2Popv1Z7BfwD7A4lfbclMqIsw/CIvM21fRmbCGfOIemqcCsyxuHtp5a+jDlH+BwXWu6
cGKdjd+TpQrEdQu3pHxOPP9e+vmbWQ==",
"listprice": 67065191,
"listpriceDateTime": "2020-08-05 00:00:00",
"merchantId": "896666818",
"resMessage": "SUCCESS!",
"sourceCurrency": "USD",
"status": "SUCCESS",
"targetCurrency": "CNY",
"tradeUnit": 10000000
}
]]>