批量代付(文件)

功能概述

商户通过此接口提交批量代付数据,同一批次最高5000条

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 M
currency 代付金额币种 varchar(15) CNY M
amount 代付金额 varchar(18) 单位:分(如:1元=100) M
transferMode 代付类型 固定值 TRANSFERTOBANKCARD : 转账至银行卡 M
detailPath 代付明细文件 varchar(200) 需上传到sftp服务/transfer/domestic/details目录下。见开发者服务-sftp数据传输说明
文件名称格式必须是:订单号_YYYYMMDD.xlsx
代付明细文件模版
M
notifyUrl 通知地址 varchar(200) 订单终态后首信易支付会向该地址发送五次成功通知,"www.5upay.com/callback.action" M
remark 备注 varchar(64) 商户备注 O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "amount": "3", "merchantId": "890000593", "requestId": "172***55996", "transferMode": "TRANSFERTOBANKCARD", "hmac": "MBHOeO1kv...nXpjXqDl4JA/TOpeSA==", "notifyUrl": "https://sdk.5upay.com/transferDomestic/notify_V3", "currency": "CNY", "remark": "", "partnerId": "", "detailPath": "172***55996_20240927.xlsx" }

同步返回参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商id 同请求参数
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
status 请求状态 SUCCESS 发起成功(不代表代付成功,只能说明代付请求成功提交至首信易系统)
FAILED 发起失败,重新发起
ERROR (此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "partnerId": "", "merchantId": "890000593", "requestId": "172***5996", "hmac": "CwM1L...PRpAiYga9VE8UOvA==", "status": "SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
requestId 订单号 同请求参数
remitRequestId 明细订单号 同请求参数
serialNumber 交易流水号 首信易系统交易流水号
amount 代付金额 单位:分,1元=100分
currency 代付币种 默认人民币CNY
remark 备注 在下单请求中提交的备注信息
status 状态 SUCCESS 打款到账成功
FAILED 打款失败,重新发起
CANCEL 打款取消,重新发起
completeDateTime 完成时间 代付完成时间
errorMessage 错误信息 代付失败后会返回此参数告知商户代付失败原因
merchantId 商户编号 同请求参数
partnerId 服务商id 同请求参数
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

注意:
1、每笔代付明细订单处理完成后都会发异步通知;
2、每笔代付明细处理完成后,系统单独发异步通知,不能保证商户收到通知的顺序与处理代付明细的顺序一致;

参数示例

{ "requestId": "152***492", "serialNumber": "832f3f1bdab***f46d3ff7e3", "detailRequestId": "1527***2492_1", "amount": "1000", "currency": "CNY", "remark": "备注", "status": "SUCCESS", "completeDateTime":"2018-03-08 17:01:54", "errorMessage":"", "merchantId": "890000593", "partnerId": "", "hmac": "959e138ad2e290...f6ZCfP4sB09nht/A==", }