4.2【银行子账户支付】接口


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

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

接口代码(transCode):2081

接口说明:

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

2.当“平台商户自有资金交易类型”为C时,交易金额=收款用户收款金额+平台商户自有资金交易金额;

3.当“平台商户自有资金交易类型”为D时,交易金额+平台商户自有资金交易金额=收款用户收款金额;

4.平台商户自有资金交易类型”字段,上送“N:无资金动账”:“tradeAmount-交易金额”等于“receiveAmount-收款用户收款金额”;

说明:华通银行不支持平台分成,平台优惠。华通支持T+0和T+1账期结算, T+0和T+1根据客户平台配置。

  • 使用账户余额进行支付,T+0结算的,实时从付款人账号划账至收款人账号。
  • T+1结算的,实时从付款人账号划账至收款人账号,并做对应的支付冻结,每天早上8点进行结算,把T日交易的支付冻结资金进行解冻

4.订单子账户支付,无异步通知,接口实时响应。

注意:该功能默认关闭,需在平台商户入网时单独找银行申请。

业务请求参数

字段

字段类型

必填

字段名称

说明

reqTraceNum

String

商户业务订单号

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

 

reqSubTraceNum

String

商户业务子订单号

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

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

中信银行必填,华通银行无需上送

payerSignNum

String

付款商户会员编号(资金转出方)

 

payerSubAcctNo

String

付款商户银行子账号

上送银行用户编号

payerName

String

付款商户会员名称(资金转出方)

 

receiverSignNum

String

收款商户会员编号(资金转入方)

 

receiverSubAcctNo

String

收款商户银行子账号

上送银行用户编号

receiverName

String

收款商户会员名称(资金转入方)

 

receiveAmount

Long

收款用户收款金额,单位:分

 

tradeAmount

Long

交易金额,单位分

 

selfFlag

String

平台商户自有资金交易类型

D:平台优惠

C:平台分成

N:无资金动账

当“平台商户自有资金交易类型”为C时,交易金额=收款用户收款金额+平台商户自有资金交易金额

当“平台商户自有资金交易类型”为D时,交易金额+平台商户自有资金交易金额=收款用户收款金额

“中信银行”托管,必填;

华通银行,此字段仅上送“N:无资金动账”

selfAmount

Long

平台商户自有资金交易金额,单位:分

例如:89.00元,金额不能为负数。

P_ SELF_FLAG为C时,应小于交易金额。

P_ SELF_FLAG为N时,该字段金额应为0.00

华通银行,上送0 

fundType

String

资金类型/商品信息

“华通银行”托管,上送“商品信息”(必填)

“中信银行”托管,上送“资金类型”

remark

String

备注

 

响应请求参数

字段

字段类型

必填

字段名称

说明

result

String

订单状态

 

respTraceNum

String

通联订单号

 

reqTraceNum

String

商户订单号(支付订单)

 

chnlTradeCode

String

银行侧交易流水号

业务返回码=00000,返回

chnlTradeDate

String

银行侧交易日期

 

chnlTradeTime

String

中信侧交易时间

 

respCode

String

业务返回码

00000:代表成功

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

其他返回码:均代表失败

respMsg

String

业务返回说明

 

maxy2 2024年12月24日 11:34 收藏文档