汇款凭证生成接口
功能描述
商户可通过此接口为成功的无因订单生成汇款凭证，接口返回SFTP文件路径，商户连接SFTP下载凭证文件。每次请求凭证文件在SFTP中留存30个自然日，过期清除。过期清除后可调用该接口重新生成汇款凭证。
接口地址
https://apis.geoswift.com/remittance/voucher/create
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在汇元通系统的唯一id，可在商户后台查看 |
M |
| orderRequestId |
商户订单号 |
varchar(50) |
汇款时的商户订单号 |
M |
| partnerId |
服务商 id |
varchar(9) |
二级商户上属服务商商户在汇元通系统 的唯一身份标识（如果发起商户自身即为 主商户此项可不传） |
C |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"hmac":"isnV9hbvCRAeDNPHhktXYwxyt4niXHmE+QLmZjYl4F5PfFT1l4L3r5GiVTDru8fBtCxlx5z0VOlxB
7oeTGUdzYV6ar5Mb8fv3tv9RLhlEPIb3l0w/FAMTP/RTG50qSDcj7OX91RWMYnFV/Av7Sn0NMiThUPLFLyee
VhgvtCxTFTqv55bmh2uSyKOuHNkZQBmiFENw4lXxcHcLoVDv3ZRvrOM2QK9UfksWJR71ZDpAmhckzH2SwOq1
kPv22RaLSmnXOMZ9NiyGpuCmfwcNBJLJxlj0NO+lqTIPGMNVhjoCFwI0F+MN4svvU6cpqn0wz3CTlI1lVkp0
zgcS+e6oGhOJA==",
"merchantId":"G90008001",
"orderRequestId":"1680230108112"
}
]]>
返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| orderRequestId |
商户订单号 |
同请求参数 |
| filePath |
文件路径 |
SFTP文件路径 |
| status |
请求状态 |
SUCCESS 成功 |
| ERROR 错误 |
| partnerId |
服务商 id |
同请求参数 |
| hmac |
参数签名 |
汇元通生成的参数签名结果，验签过程请参考解密流程 |
示例
<![CDATA[
{
"filePath":"/report//remittance/receipt/20230331/1680230108112_20230331.pdf",
"hmac":"e6O3Bg7znofoinvNGB4X6LflHrVZE2oKO48Bg4rpWm6FXX9l21fNYSMGs91m291xtGcMGkcubpMiic5s
oZ0YMMgqSii8EqxG6q+9+1Jwf2h4TtdMscOoSAwcIA1Bs1w0KAaWCoYB2JB5t1gf1j+UUbpZrZH2es67KM/xLp9T
73eg7lm5UJsyo7COPuD39HZgZ0cTRh6dlg5IdwJGx/C1Kc5VBrhjkp6Kt6P+tHdTxCDGz69TkucL2jiyOkezcz/p
SBvuWxg2AwE5p1Iscq3W2uhwItWYC60MQY5MjGgpxgs2Z6No0ZTsoYFdLSD9ab1WY1K8qfVyF+cZLLnwpBzCjg==",
"merchantId":"G90008001",
"orderRequestId":"1680230108112",
"status":"SUCCESS"
}
]]>