子商户回单批量生成接口

功能概述

服务商可请求,可针对某一日,将其下所有子商户的成功账户间转账交易,批量生成电子回单,可保留7个自然日。
生成文件每5000个回单一个压缩包,单日超过5000个则会生成多个压缩包。

接口地址

https://apis.5upay.com/transferAccount/generateSubTransferVoucher

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 服务商编号 M
requestId 订单编号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一,商户平台不能以相同的订单号再次提交 M
createDate 账户间转账创建日期 varchar(10) 账户间转账交易的创建日期,格式:yyyy-MM-dd,需小于当前日期 M
notifyUrl 通知地址 varchar(200) 服务器通知:当订单状态为终态后首信易服务器会向该地址发送通知,如:http://www.5upay.com/callback.action M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "merchantId": "890000593", "requestId": "1745294197150", "createDate": "2025-03-03", "notifyUrl": "https://open.payeasenet.com/notify.php", "hmac": "r9fg+66Cs...WKDEb7Qt3YOnj6Ab9RmnwciQ==" }

同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
createDate 账户间转账创建日期 同请求参数
status 状态 SUCCESS 请求成功
ERROR 错误(此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "createDate": "2025-03-03", "merchantId": "890000593", "requestId": "1745294197150", "status": "SUCCESS", "hmac": "r9fg+66Cs...WKDEb7Qt3YOnj6Ab9RmnwciQ==" }

异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
createDate 账户间转账创建日期 同请求参数
status 状态 SUCCESS 请求成功
FAILED 电子回单生成失败或所请求日期范围内无结果
downloadUrl 回单地址 账户间转账回单地址,需要连接ftp获取对应的回单压缩包,ftp连接方式对账sftp数据文件
路径:/report/transfer_account/transferVoucher/partner/日期/压缩包名称.zip
当有多个压缩包时,会返回多个回单地址,以半角分号分隔
压缩包名称:yyyymmdd-序号.zip 单个电子回单名称:商户编号-账户间转账的商户订单号.pdf
errorMessage 错误信息 生成账户间转账回单失败后返回失败原因
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "890000593", "requestId": "1745294197150", "hmac": "tRHEW1lcGW...PoJluqsFA3BCnv+iyg==", "downloadUrl": "/report/transfer_account/transferVoucher/partner/20250422/20250303-01.zip", "createDate": "2025-03-03", "status": "SUCCESS" }