测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2080
功能说明:
(1)当客户侧服务器返回 success 时 (注:不是"success"),则认为通知成功,停止通知。接收通知及相应的代码示例:[附件]AsyncMessageHandDemo.java.zip
(2)支持华通银行托管模式下:收单机构收款资金结算至银行账户后,发送此通知(云商通无订单,无账务处理)。
(3)支持民生银行托管模式下:余额变动通知(创建“银行子账户充值”订单)。
(4)支持中信银行托管模式下,汇款入金通知(无订单)。
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
openBankNo |
String |
4 |
否 |
开户银行编码 |
银行存管模式,返回 1021:华通银行 1001:中信银行 1029:民生银行 |
|
chnlTradeCode |
String |
50 |
是 |
渠道流水号 |
中信银行:银行流水号 华通银行:银行流水号 民生银行:银行侧“第三方订单号” |
|
reqTraceNum |
String |
50 |
否 |
商户订单号 |
中信银行:流水号 华通银行:不返回 民生银行:银行侧“第三方订单号” |
|
respTraceNum |
String |
40 |
否 |
通联订单号 |
中信银行:不返回 华通银行:不返回 民生银行:返回 |
|
payAcctNo |
String |
32 |
是 |
来款账号 |
中信银行、华通银行、民生银行:打款方账号 |
|
payAcctName |
String |
32 |
否 |
来款账户名 |
中信银行、华通银行、民生银行:打款方账户名称 |
|
receiveAcctType |
String |
1 |
是 |
入账账户类型 |
华通银行:8-银行结算账户 中信银行: (1)12-中信客户账户 (2)13-中信内部账户
民生银行: 7:应用银行账户 |
|
signNum |
String |
60 |
否 |
入账商户会员编号 |
华通银行:针对“8-银行结算账户”,则无值,不返回
中信银行、民生银行:入账的商户会员编号
|
|
inAcctNo |
String |
32 |
否 |
入账账号 |
中信银行:入账的交易资金账号(母户) 华通银行:针对“8-银行结算账户”,返回银行存管账户名,取值【应用资金管理模式管理】菜单“结算账号” 民生银行:不返回 |
|
inAcctName |
String |
32 |
否 |
入账会员名称 |
中信银行、民生银行:入账的会员名称 华通银行:针对“8-银行结算账户”,返回银行存管账户名,取值【应用资金管理模式管理】菜单“开户名称” |
|
orderAmount |
Long |
20 |
是 |
入账金额 |
汇入金额 单位:分 |
|
transDateTime |
String |
20 |
是 |
入账时间 |
yyyy-MM-dd HH:mm:ss |
|
result |
Long |
1 |
是 |
入账状态 |
1:入账成功 2: 入账失败
|
|
summary |
String |
100 |
否 |
交易附言 |
中信、华通、民生银行:渠道附言 |
|
receiptNo |
String |
50 |
否 |
银行子账号 |
中信、民生银行:银行子账户账号 华通银行:不返回 |
|
remark |
String |
100 |
否 |
备注 |
民生、中信银行返回 |
|
extendParams |
json |
|
否 |
银行通知json |
中信银行返回 民生银行返回 |
extendParams-民生银行通知json字段如下:
|
字段 |
字段类型 |
字段名称 |
说明 |
|
busiCode |
String |
业务类别 |
透传“busin_Code”字段,枚举值如下 301-充值 503-结息(交易资金子账簿) 507-提现退款(如果原提现涉及手续费,则需要退还对应手续费) E01-线下充值失败的通知 |
|
bankFee |
String |
手续费金额 |
透传“bank_fee”字段 单位:分 |
|
chgFlag |
String |
余额变动标志 |
透传“chg_flag”字段 0-增加 1-减少 2-不变 |
|
balance |
String |
交易后余额 |
透传“balance”字段 |
extendParams-中信银行通知json字段如下:
|
字段 |
字段类型 |
字段名称 |
说明 |
|
txType |
String |
中信交易类型 |
01-个人用户入金 02-企业用户入金 03-平台入金 04-银联退汇 05-二代退汇 06-支付渠道入金 07-不明来账 |
|
fee |
String |
中信手续费汇总金额 |
单位:分 |
|
transType |
String |
借贷方向 |
C':贷 'D':借 |