子商户代付电子回单批量生成接口

功能概述

此接口仅支持服务商调用,可对服务商下子商户的某一个代付批次,批量生成电子回单。该接口生成回单将保留七个自然日

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单编号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一商户平台不能以相同的订单号再次提交。 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 M
remitRequestId 代付批次订单号 varchar(50) 需要生成电子回单的代付批次的订单号 M
notifyUrl 通知地址 varchar(200) 服务器通知:当订单状态为终态后首信易服务器会向该地址发送通知,如:http://www.5upay.com/callback.action M
hmac 参数签名 varchar(512) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

参数示例

{ "merchantId": "89***54", "requestId": "SD***940", "hmac": "U2lAww2lUTuRp6w==", "remitRequestId": "1731***052", "notifyUrl": "https://sdk.5upay.com/notify/batchVourcher", "partnerId": "89***93" }

同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单编号 同请求参数
partnerId 服务商编号 同请求参数
remitRequestId 代付批次订单号 同请求参数
status 请求状态 SUCCESS 成功
ERROR 错误
FAILED 失败,所请求的批次已生成过电子回单,且回单仍在下载有效期内
errorMessage 错误信息 状态为FAILED时返回
downloadUrl 回单地址 状态为FAILED时返回,已生成过且在有效期内的代付回单地址。需要连接ftp获取对应的回单压缩包,ftp连接方式对账sftp数据文件,路径:/report/domestic_transfer/transfervoucher/partner/日期/压缩包名称.zip
hmac 参数签名 获取hmac的方法见请求加密流程

参数示例

{ "merchantId": "89***54", "requestId": "FF***88", "hmac": "wp9K6M1ochl***vPztQufbTrwgAm8zwzg==", "downloadUrl": "/report/domestic_transfer/transfervoucher/partner/20241202/1728465218516.zip", "errorMessage": "该批次已生成过且在有效期内,请查看下载", "remitRequestId": "172***16", "partnerId": "89***93", "status": "FAILED" }

异步通知参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单编号 同请求参数
partnerId 服务商编号 同请求参数
remitRequestId 代付批次订单号 同请求参数
status 请求状态 SUCCESS 成功,电子回单生成成功
FAILED 失败,电子回单生成失败或该批次无成功订单
downloadUrl 回单地址 代付回单地址,需要连接 ftp 获取对应的回单压缩包,ftp 连接方式对账 sftp 数据文件,路径: /report/domestic_transfer/transfervoucher/partner/日期/压缩包名称.zip
errorMessage 错误信息 生成代付凭证失败后返回失败原因
hmac 参数签名 获取hmac的方法见请求加密流程

参数示例

{ "merchantId": "89***54", "requestId": "SD***940", "hmac": "lfZ8T8Nb3HUKWaw==", "downloadUrl": "/report/domestic_transfer/transfervoucher/partner/20241201/173***5052.zip", "partnerId": "89***93", "status": "SUCCESS" }