测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址：https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码（transCode）：2072
功能说明：
- 抽佣交易，需在原消费收款交易发生后的D+1发起。系统对账完成后，通过本接口发起分账时，系统按照原消费订单的“结算金额”进行动账处理。
- 一笔收款订单，只能分账一次。分账比例校验规则：分账金额/原消费订单金额<=分账协议中约定的分账比例。
- 支持无需平台抽佣、无需分账的场景，则调用本接口，将原消费收款订单的在途资金转为可用。
- 支持消费交易走收银宝，调用云商通的【批量分账】/【单笔订单分账】接口进行分账，此时批量分账文件中的“原通联订单号”格式固定为：VSP+交易日期+收银宝交易单号，示例：VSP20240901240901205584156。
- 商户调用本接口的时间为D+1，或T+1日（根据商户的结算周期），且确保资金已经完成结算。
- 注：平台方为代理商的场景，分公司需配置“代理商对账单”，否则无法发起分账。
- 仅支持订单类型-订单子类型为“消费-商户收款”、“消费-扫码预消费完成”、“消费-微信订单完成”的交易发起【单笔订单分账】。
- 订单分账结果通过【订单结果通知】获取。
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
|
是 |
商户订单号 |
|
|
orgRespTraceNum |
String |
|
是 |
原收款的通联订单号 |
通过【消费】接口进行收款的通联订单号 交易未通过云商通【消费】接口发起时，上送格式：VSP+原订单创建日期+收银宝trxid， 例如：VSP20240901240901205584156 |
|
couponAmount
|
Long |
|
否 |
平台抽佣金额 |
平台抽佣金额，单位：分；抽佣金额/订单金额需小于等于抽佣比例；抽佣金额向下取整 |
|
respUrl |
String |
|
否 |
后台通知地址 |
上送，则订单状态会通知到该地址 |
|
extendParams |
String |
|
否 |
扩展参数 |
最多100个字符，商户拓展参数，用于透传给商户，不可包含“|”特殊字符 |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
result |
String |
|
是 |
订单状态 |
0：进行中 1：交易成功 2：交易失败 需通过【订单结果通知】接口获取最终状态 |
|
respTraceNum |
String |
|
是 |
通联订单号 |
|
|
reqTraceNum |
String |
|
是 |
商户订单号 |
|
|
orgRespTraceNum |
String |
|
是 |
原收款的通联订单号 |
|
|
orderAmount |
String |
50 |
是 |
订单金额 |
本次需要将资金转为可用的金额 |
|
couponAmount |
|
|
否 |
平台抽佣金额 |
|
|
extendParams |
String |
|
否 |
扩展信息 |
|
|
respCode |
String |
|
是 |
业务返回码 |
00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。 其他返回码：均代表失败 |
|
respMsg |
String |
|
是 |
业务返回说明 |
|