商户通过此接口提交批量代付数据,同一批次最高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 |
以上参数值中不能包含以下特殊字符’”&<>()
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
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 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
requestId | 订单号 | 同请求参数 |
status | 请求状态 | SUCCESS 发起成功(不代表代付成功,只能说明代付请求成功提交至首信易系统) |
FAILED 发起失败,重新发起 | ||
ERROR (此状态的返回参数见异常情况说明) | ||
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
requestId | 订单号 | 同请求参数 |
serialNumber | 交易流水号 | 首信易系统交易流水号 |
remitRequestId | 明细订单号 | 同请求参数 |
amount | 代付金额 | 单位:分,1元=100分 |
currency | 代付币种 | 默认人民币CNY |
remark | 备注 | 在下单请求中提交的备注信息 |
status | 状态 | SUCCESS 打款到账成功 |
FAILED 打款失败,重新发起 | ||
CANCEL 打款取消,重新发起 | ||
completeDateTime | 完成时间 | 代付完成时间 |
errorMessage | 错误信息 | 代付失败后会返回此参数告知商户代付失败原因 |
merchantId | 商户编号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
注意:
1、每笔代付明细订单处理完成后都会发异步通知;
2、每笔代付明细处理完成后,系统单独发异步通知,不能保证商户收到通知的顺序与处理代付明细的顺序一致;