5.2【批量分账】接口


测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle

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

接口代码(transCode):2092

功能说明:

  1. 新增【批量分账】接口,用于“ISV分账”产品,收款会员向下分账 。
  2. 交易中的分账出金方/分账入金方,需要一户一审。需分公司人员在云商通二代管理后台-【会员管理-会员交易控制审核】菜单,提交至业务支撑平台审核通过后,方可进行交易。详细说明请参考:《资金非归集模式下会员审核相关操作手册》
  3. 分账交易,需在原消费收款交易发生后的D+1发起。系统对账完成后,通过本接口发起分账时,系统按照原消费订单的“结算金额”进行动账处理。
  4. 一笔收款订单,只能分账一次。
  5. 支持无需平台抽佣、无需分账的场景,则调用本接口,将原消费收款订单的在途资金转为可用。
  6. 支持消费交易走收银宝,云商通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

业务返回说明

 

maxy2 2025年1月17日 16:34 收藏文档