4.18【平台收付款】接口


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

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

接口代码(transCode):2088

接口说明:

1.商户业务订单号+商户业务子订单号应保证唯一。

2.当“操作类型”为01-平台付款时,资金流向为:平台银行子账户-->会员银行子账户;

3.当“操作类型”为02-平台收款时,资金流向为:会员银行子账户-->平台银行子账户;

注意:该接口仅支持中信银行托管的客户进行调用,且功能使用前会涉及到银行侧限额的配置,需在平台商户入网时单独找银行申请配置相关限额。

业务请求参数

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

商户业务订单号

该笔业务订单由平台商户端生成的业务订单号

 

reqSubTraceNum

String

商户业务子订单号

该笔业务订单下每笔业务子订单由平台商户端生成的唯一标识

商户业务订单号+商户业务子订单号应保证唯一。

operateType String 操作类型 01:平台付款、02:平台收款
dealType String 交易类型 平台付款时,交易类型如下:
00-优惠补贴
01-垫付
02-奖励
03-其他
04-佣金返还
平台收款时,交易类型如下:
00-分成服务费
01-违约金
02-罚款
03-其他
signNum String 收付款会员编号

操作类型为01-平台付款时,对应的为收款会员的相关信息;

操作类型为02-平台收款时,对应的为付款会员的相关信息;

当收付款会员为平台担保户时,支持上送#yunBizUserId_B2C#

subAcctNo String 收付款银行子账号  
name String 收付款会员名称  
tradeAmount Long 交易金额,单位分  
fundType String 资金类型/商品信息  
remark String 备注  

响应请求参数

字段

字段类型

字段名称

说明

result String 订单状态  
respTraceNum String 通联订单号  
reqTraceNum String 商户订单号(支付订单)  
chnlTradeCode String 银行侧交易流水号  业务返回码=00000,返回
chnlTradeDate String 银行侧交易日期  
chnlTradeTime String 中信侧交易时间  
respCode String 业务返回码  

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg String 业务返回说明  

 


tangjh2 2025年11月26日 18:17 收藏文档