测试地址: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 |
否 |
业务返回说明 |