测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2092
功能说明:
- 新增【批量分账】接口,用于“ISV分账”产品,收款会员向下分账 。
- 交易中的分账出金方/分账入金方,需要一户一审。需分公司人员在云商通二代管理后台-【会员管理-会员交易控制审核】菜单,提交至业务支撑平台审核通过后,方可进行交易。详细说明请参考:《资金非归集模式下会员审核相关操作手册》
- 分账交易,需在原消费收款交易发生后的D+1发起。系统对账完成后,通过本接口发起分账时,系统按照原消费订单的“结算金额”进行动账处理。
- 一笔收款订单,只能分账一次。
- 支持无需平台抽佣、无需分账的场景,则调用本接口,将原消费收款订单的在途资金转为可用。
- 支持消费交易走收银宝,云商通D+1日获取到交易数据后,调用云商通的【批量分账】接口进行分账,此时批量分账文件中的“原通联订单号”格式固定为:VSP+交易日期+收银宝交易单号,示例:VSP20240901240901205584156。
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
batchNo |
String |
20 |
是 |
批次号 |
|
totalCount |
String |
是 |
分账笔数 |
最多支持5000笔 |
|
respUrl |
String |
256 |
是 |
后台通知地址 |
将回盘处理结果通知到该地址 |
file |
byte |
是 |
文件明细 |
【批量分账】文件, 文件的byte数组进行base64加密后的字符串 |
文件明细格式
示例:
商户订单号|原收款的通联订单号|平台抽佣金额|分账信息|扩展信息
trx001|20240711123456|1|[{"signNum":"123","amount":100,"remark":"123"},{"signNum":"234","amount":200,"remark":"234"}]|拓展信息1
trx002|20240711123457|2|
|[{"signNum":"123","amount":100,"remark":"123"}]|拓展信息2
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
商户订单号 |
全局唯一不可重复 |
orgRespTraceNum |
String |
50 |
是 |
原收款的通联订单号 |
通过【消费】接口进行收款的通联订单号 交易未通过云商通【消费】接口发起时,上送格式:VSP+日期+收银宝trxid, 例如:VSP20240825240918126000021633 |
couponAmount |
Long |
否 |
平台抽佣金额 |
平台抽佣金额,单位:分; |
|
signNum |
String |
否 |
分账人商户会员编号 |
“signNum、amount、remark”为一组数据,可以有多组; 一组为一个分账人信息; |
|
amount |
Long |
否 |
分账金额 |
||
remark |
String |
否 |
备注 最长50个字符 |
||
extendParams |
String |
200 |
否 |
扩展参数 |
最多100个字符,商户拓展参数,用于透传给商户,不可包含“|”特殊字符 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
batchNo |
String |
20 |
是 |
批次号 |
|
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
业务返回说明 |