查询接口
功能概述
商户通过跨境收款查询接口查询首信易支付平台的订单状态，并且通过主动查询订单来获知订单信息。
接口地址
https://apis.5upay.com/foreignpayExchangesettlement/query
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。 |
M |
| requestId |
订单号 |
varchar(50) |
订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单，商户平台不能以相同的订单号再次提交。 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId":"896667346",
"requestId":"1621307590890",
"hmac":"F3tLKrJgvoBsd/WtNA3+I7rLg3xZRaqIbtsiPu+xCjhIkoI7T16+fx1hzbkeP5eIMg4XLfD4yE+GAbqlZx
k9E1SMbB2LSUQzrVslEd4M0nofH1l7eh4eBu6tYRpWxf5AT//+QAmW40/yY+jqxvGculVzkUnIyTzxPTsxOUeSWMwL
mrTiwcY90wvlYz+VL9IQWJ42ciWgdWvB5WWr3lkPKaI6WKXXZHlR+wiIYIbCI7lHXSs+01rcAOzn+T3HSjXjjMvYb6
VpzSUYxFrRFkJKoeDZ5XnMKwbRyxyVUPKB996aUIwU3qauJoEYbm4Jn3L5Um6oNo8SHtS+sC/nVsE/Yw=="
}
]]>
订单查询返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。 |
| requestId |
订单号 |
订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单，商户平台不能以相同的订单号再次提交。 |
| status |
订单状态 |
处理中 PROCESSING |
| 成功 SUCCESS |
| 失败 FAILED |
| 错误 ERROR |
| serialNumber |
交易流水号 |
首信易系统交易流水号 |
| currency |
订单币种 |
见货币列表 |
| amount |
订单金额 |
订单金额，单位为分 |
| remark |
备注 |
备注 |
| foreignExchange |
结汇信息JSON |
见下表,结汇信息 |
| paymentModeAlias |
支付方式 |
FOREIGN-FOREX-ECITIC-P2P 国际银行电汇 |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
返回参数（foreignExchange，结汇信息）
| 参数名称 |
参数中文名称 |
参数说明 |
| amount |
结汇金额 |
单位:分，1 元=100 分 |
| currency |
结汇币种 |
见货币列表 |
| status |
结汇状态 |
待处理 INIT |
| 处理中 PROCESSING |
| 结汇成功 SUCCESS |
| 结汇失败 FAILED |
| 取消 CANCEL |
| listprice |
交易牌价 |
商户牌价 |
| completeDateTime |
结汇完成时间 |
结汇完成时间 |
示例
<![CDATA[
{
"merchantId":"896667346",
"requestId":"1621307590890",
"serialNumber":"2c998074797a156e01797d7b5b9a0000",
"orderCurrency":"USD",
"orderAmount":"10000",
"remark":"remark",
"foreignExchange":{},
"paymentModeAlias":"FOREIGN-FOREX-ECITIC-P2P",
"status":"PROCESSING",
"hmac":"kAGBnDb3V6KNYAHwzuD3ZtdDvq5UT5/gWT4MeZSfaMIN8XXn5grmi9GzlCrZaLb7eXDPlXZwmDuE0JXY/OL
b1cd/VeIGe4Ilab4sg1v69wlHhUnez2eIIYYFmERv8gRwyfcz+duQYuG4pxTfw55NLDqLlvxaGvl7jaNL3wISYqNpPl
3jiKs7WZ2KwMnyk3dbAJK1q7CNumFUgwGNJXXtp3QbYNhzh0l4BFxnJj8HnEPO5tmamwP0dMBKPyMgUwQPB+qQXpJGk
43CPRwfaODpjSGNJyFlc2hlNZMQvOqIz3J0PQSg8myQCAAyIsQpZAN8XCKz7apH4IBVcs9VPkxqKw=="
}
]]>