5.2【批量分账】接口


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle

接口代码(transCode):2092

功能说明:

  1. 新增【批量分账】接口,用于平台抽佣,不支持分账的场景。
  2. 调用本接口,将原消费收款订单的在途资金转为可用。
  3. 支持消费交易走收银宝,商户调用云商通的【批量分账】接口进行分账,此时批量分账文件中的“原通联订单号”格式固定为:VSP+交易日期+收银宝交易单号,示例:VSP20240901240901205584156。
  4. 商户调用【批量分账】接口的时间为D+1,或T+1日(根据商户的结算周期),且确保资金已经完成结算。
  5. 注:平台方为代理商的场景,分公司需配置“代理商对账单”,否则无法发起分账。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

batchNo

String

20

批次号

 

totalCount

String

 

分账笔数

最多支持5000笔

respUrl

String

256

后台通知地址

将回盘处理结果通知到该地址

file

String

 

文件明细

【批量分账】文件,

文件的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

业务返回说明

 

maxy2 2025年9月4日 19:03 收藏文档