电子回单生成

功能概述

商户通过此接口查询代付电子回单。

代付回单只可保存一天请注意及时下载

接口地址

https://apis.5upay.com/transferDomestic/generateTransferVoucher

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
remitRequestId 代付唯一标识号 varchar(50) 原代付订单订单号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "merchantId": "890000***", "requestId": "152774660****", "partnerId": "890000***", "remitRequestId": "152774660****", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商编号 同请求参数
remitRequestId 代付唯一标识号 原代付订单订单号
downloadUrl 代付回单地址 代付回单地址,需要连接ftp获取对应的回单图片,ftp连接方式对账sftp数据文件,路径:/report/domestic_transfer/transfervoucher/日期/图片名称.pdf
status 请求状态 SUCCESS 成功
ERROR 查询失败(此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "downloadUrl": "/report/domestic_transfer/transfervoucher/20201022/111111.pdf", "hmac": "Gk5UHUK0k0q1BlONeRfeU5XHn8Jas9wjbPl1CjjxmQlA9We3eUumZ5qa0KqqUCIsbq3 9RsPP15XB3yX4PqFyDYBTWmw1d4QECtSfbtIvJ46gWrXjfysyWSzdXAKsholOxVHjiXUVGom GWBer/HtcolIVWQrjKnL0VXj9+Q/igxHL/e7KMJdP4ZNXpm9w8UfIj+P4qoApdnb8sqlJ2O0 ZD5pqy1YTTYMvjiJIw8mt25gk7/WzrwcS0Yogxy9iVfAeU+2A3/WAipyShFOHYGgJKCny5XQ Le2Boeaa/ByZW4IwS2GIbP6a84NMRHYsEPH8NVKvpnDn7FWO7cZhBzd91vg==", "merchantId": "89667****", "partnerId": "", "remitRequestId": "c9cfc0dd384f4e9ebaefdeb875a6****", "requestId": "1234567890***", "status": "SUCCESS" }