批量代付(非文件)

功能概述

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

接口地址

https://apis.5upay.com/transferDomestic/batch/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
notifyUrl 通知地址 varchar(200) 订单终态后首信易支付会向该地址发送五次成功通知,"www.5upay.com/callback.action" M
remark 备注 varchar(64) 商户备注 O
payees 收款人信息 Json数组 见payees表 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

请求参数(payees,收款人信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
remitRequestId 明细订单号 varchar(100) 明细订单号为商户自行拟定,提交的明细订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的明细订单号再次提交。 M
name 收款人姓名 varchar(100) 收款方姓名 M
bankCardNum 银行卡号 varchar(100) 银行卡号 M
bankName 银行名称 varchar(100) 代付到对公账户时此项必填。银行名称参照批量代付模板(商户后台-账户中心-代付-发起代付-批量-下载模板.xlsx) C
detailAmount 明细金额 varchar(18) 单位:分(如:1元=100) M
detailRemark 明细附言 varchar(64) 明细附言 O

参数示例

{ "amount": "3", "merchantId": "890000593", "payees": [ { "bankCardNum": "601***0504", "bankName": "", "branchBankName": "", "detailAmount": 1, "detailRemark": "", "remitRequestId": "17274***38835_1", "name": "张三" }, { "bankCardNum": "620***8450", "bankName": "", "branchBankName": "", "detailAmount": 2, "detailRemark": "", "remitRequestId": "172743***8835_2", "name": "李四" } ], "requestId": "17274***38835", "transferMode": "TRANSFERTOBANKCARD", "hmac": "MC8hSE6BSdln...f6ZCfP4sB09nht/A==", "notifyUrl": "https://sdk.5upay.com/transferDomestic/notify_V3", "currency": "CNY", "remark": "", "partnerId": "" }

同步返回参数列表

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

参数示例

{ "merchantId": "890000593", "requestId": "1527****02492", "hmac": "959e138ad2e290...328e8d59fd124c618f", "status": "SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
requestId 订单号 同请求参数
serialNumber 交易流水号 首信易系统交易流水号
remitRequestId 明细订单号 同请求参数
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==", }