子商户提现电子回单批量生成接口

功能概述

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

接口地址

https://apis.5upay.com/wallet/withdrawCertificatePartner

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
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(512) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

参数示例

{ "merchantId": "89***93", "requestId": "170***005", "hmac": "SdL5rMiT8Om0arHkVtUXtKA/w==", "notifyUrl": "https://sdk.5upay.com/notify/batchVourcher", "createDate": "2023-01-06" }

同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单编号 同请求参数
createDate 提现创建日期 同请求参数
status 请求状态 SUCCESS 成功
ERROR 错误
hmac 参数签名 获取hmac的方法见请求加密流程

参数示例

{ "merchantId": "89***93", "requestId": "170***005", "hmac": "2cDpt3pykSUJ0rr1Tg==", "createDate": "2023-01-06", "status": "SUCCESS" }

异步通知参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单编号 同请求参数
createDate 提现创建日期 同请求参数
status 请求状态 SUCCESS 成功,电子回单生成成功
FAILED 失败,电子回单生成失败或该批次无成功订单
downloadUrl 回单地址 提现回单地址,需要连接 ftp 获取对应的回单压缩包,ftp 连接方式对账 sftp 数据文件,路径: /report/merchant_withdraw/merchant_withdraw/partner/日期/压缩包名称.zip 当有多个压缩包时, 会返回多个回单地址,以半角分号分隔。/td>
errorMessage 错误信息 生成提现凭证失败后返回失败原因
hmac 参数签名 获取hmac的方法见请求加密流程

参数示例

{ "merchantId": "89***93", "requestId": "170***005", "hmac": "BfzESDY8c5BClMySXg==", "downloadUrl": "/report/merchant_withdraw/merchant_withdraw/partner/20241202/20230106_0.zip", "createDate": "2023-01-06", "status": "SUCCESS" }