收付通API

通联核心产品文档中心

3.8异步通知接口

目录

3.8异步通知接口

异步通知类的发起方为通联服务器，接收端为商户服务器（通知地址是 https协议应使用默认端口，如果是非常规端口均需申请配置才能访问，请联系技术人员，没有回复success（商户返回字符串中含有，200003接口特殊，包含0000也不会重发通知）会发3次，时间间隔不固定，用的是http1.1）。签名算法支持国密或rsa，默认rsa，如需国密，可登陆后台 运行参数，通知参数进行配置。

3.8.1 退票通知

3.8.1.1 报文功能

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l针对跨行代付交易，当发送退票时，由此接口通知给商户。

参数信息都是原交易信息

3.8.1.2 请求报文

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

 

参考b6的返回码（3056）

非空

 

RETMSG

错误信息

C(1,256)

 

可空

退票原因

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

 

MOBILE

手机号/小灵通

C (1,13)

小灵通带区号，不带括号，减号

可空

 

AMOUNT

金额

N(1,12)

整数，单位分

非空

 

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

 

FINTIME

完成时间

C(14)

 

非空

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

 

BATCHID

交易流水号

C(60)

原请求报文中的交易流水REQ_SN

非空

 

SN

记录序号

C(4)

原交易的记录序号SN，单笔默认为0

非空

 

TRXCODE

交易代码

C(1, 20)

 

可空

 

POUNDAGE

手续费

N(12)

整数，单位分

可空

 

USERCODE

用户代码

C(20)

用户自定义ID

可空

 

TRXTYPE

交易类型

C(1)

0差错类交易 1普通交易

可空

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为 账号|手机号|金额|交易流水号|记录序号|手续费

非空

 

 

3.8.1.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

 

3.8.2 商户主动划款入账通知

3.8.2.1 报文功能

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l商户主动划款到通联通，通过此接口通知商户商户的余额户已入账。

l支持内部转账入金通知，根据通知的TRXCODE字段值区分;  100100-商户主动划款  100402--内部转账收。

3.8.2.2 请求报文

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

 

参考b6的返回码

非空

 

RETMSG

错误信息

C(1,256)

 

可空

 

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

 

MOBILE

手机号/小灵通

C (1,13)

小灵通带区号，不带括号，减号

可空

 

AMOUNT

金额

N(1,12)

整数，单位分

非空

 

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

 

FINTIME

完成时间

C(14)

 

非空

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

 

BATCHID

交易流水号

C(60)

原请求报文中的交易流水REQ_SN

非空

 

SN

记录序号

C(4)

原交易的记录序号SN，单笔默认为0

非空

 

POUNDAGE

手续费

N(12)

整数，单位分

可空

 

USERCODE

用户代码

C(20)

商户客户ID

可空

 

MERID

商户号

C(16)

 

可空

 

INACCT

资金来源

C(1，64）

 

可空

 

INACCTNAME

汇入账号

C(1，64）

 

可空

 

MEMO

附言

C(1，128）

summary的值

可空

 

TRXTYPE

交易类型

C(1)

0差错类交易 1普通交易

可空

 

TRXCODE

交易代码

C(1，20）

 

可空

 

REMARK

备注

C(1，50）

 

可空

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为 账号|手机号|金额|交易流水号|记录序号|手续费

非空

 

 

3.8.2.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

 

3.8.3 快捷单笔交易结果通知

3.8.3.1 报文功能

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l 快捷单笔交易结果通过此接口通知商户，包括成功与失败的交易。

3.8.3.2 请求报文

URL参数名

说明

类型

取值

限制

备注

RETCODE

返回码

C(4)

 

参考b6的返回码

M

 

RETMSG

错误信息

C(1,256)

 

C

 

ACCOUNT_NO

账号后4位

N(1,32)

借记卡或信用卡后4位

M

 

MOBILE

手机号/小灵通

C (1,13)

小灵通带区号，不带括号，减号

C

 

AMOUNT

金额

N(1,12)

整数，单位分

C

 

SETTDAY

清算日期

C(8)

yyyyMMdd

M

 

FINTIME

完成时间

C(14)

yyyyMMddHHmmss

M

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

M

 

BATCHID

交易流水号

C(60)

原请求报文中的交易流水REQ_SN

M

 

SN

记录序号

C(4)

原交易的记录序号SN，单笔默认为0

M

 

USERCODE

自定义用户号

C(20)

原交易的CUST_USERID

C

 

MERID

商户号

C(15)

商户号

M

 

 REMARK

备注

C (1,50)

备注

c

 

VOUCHERNO

银行流水号

C(1,16)

 

C

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为返回码|账号|手机号|金额|交易流水号|记录序号

M

 

 

3.8.3.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

3.8.3.4 例子

http://172.16.1.12:8282/techsp/helper/basicdef/tlt/basicdef.html?RETCODE=0000&RETMSG=%E5%A4%84%E7%90%86%E6%88%90%E5%8A%9F&ACCOUNT_NO=62178808000104315861&MOBILE=&AMOUNT=20000&SETTDAY=20180511&FINTIME=20180511151749&SUBMITTIME=20180511151747&BATCHID=200604000004497-1526023069833&SN=0&POUNDAGE=0&USERCODE=252523524253xx&TRXTYPE=1&SIGN=3d6a1ec6ee95594aa710cf4445c17bcc99021c6b1cb73dfaa561188930f796b59c2ad037d1df7a5a25a93fac54d516144d12cd74197023ef8bed13689784a814862887fb2bcded96e67ea1c1412ede2030680b6116bf86ea6c38dd25ee62ef0eded40a1aeda962a04ef37bbf58e933924721b52ddec7c7f6297da890dfd6579e35f46c63d2bde5ba736a6578dba25160bbb5a0a9018e910f636a895e42af2ab9629f2a2d25e13d4ccc53db97c1b14509e4d753856bbcc33434e9812b1e72875720d70d44975e5fa893d6f3df9d72cdf46d601fc403da2710bc5252ed42076cd400c8a9081855e052a0f6b02179618147c1fa7d5894ad593d44a3b137a9dd01ee

3.8.4 批量交易完成通知(200003)

3.8.4.1 报文功能

l报文通讯方式：HTTP/HTTPS+POST方式，商户需提供接收通知的URL。

l 该通知接口适合批量交易的通知，仅代表该批次交易已处理完成，具体的处理结果如成功或者失败，需商户通过交易结果查询（200004）进行查询。

3.8.4.2 请求报文

接口

字段ID

字段名称

类型

取值

可空

备注

INFO

TRX_CODE

交易代码

C(1, 20)

200003

否

 

VERSION

版本

C(2)

04

否

 

DATA_TYPE

数据格式

N(1)

2：xml格式

否

 

REQ_SN

交易批次号

C(60)

 

 

 

SIGNED_MSG

签名信息

C

 

否

 

NOTIFY

NOTIFY_SN

原请求报文中的交易流水REQ_SN

C(40)

 

否

请求报文的交易流水

数字签名原文为没有SIGNED_MSG 签名信息项的xml全文。

 

3.8.4.3 响应报文

返回success或者0000

3.8.4.4 例子

<?xml version="1.0" encoding="GBK"?>
<AIPG>
<INFO>
<TRX_CODE>200003</TRX_CODE>
<VERSION>03</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>1526023770097</REQ_SN>
<SIGNED_MSG>90fb40f1b332cc76aa6747d003b30683af9ca7ec1f44d61119a8fd9f0fffbf8e848ec705b9f1c0bcb5a53279caac1a899112793fd33d012e6776e27da0b850002ee3e2eeb7bed366a63e3f050fae5bbd1f4b634a65c51466019bd63c8666746a81e3ae6fa908965a7585ca4e3920a4638fac4ea36c9387b4519f68b7ce75170ef90b5c4c55ffbe70a1726f5161e6c642bd94b21b5b9bf3a64a9d758bc8792c5eda1e40b9dd306716a6cd134ffa24869f330a32e699f3600983cad6b42d1abc01577725329cc73a9a5594668fafeabf904d428995062961b62c9da9e7e6e8d323b5ea5ff9fc01c427e5f759701110acbb3ea9324ea39522d78d0d02933e01f9f5</SIGNED_MSG>
</INFO>
<NOTIFY>
<NOTIFY_SN>200604000004497-1526023772031</NOTIFY_SN>
</NOTIFY>
</AIPG>



3.8.5 代收付单笔成功交易结果通知

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l代收付单笔成功交易结果通过此接口通知商户。

交易类型：实时收款、实时付款、批量收款（对应的明细交易）、批量付款（对应的明细交易），退款。

3.8.5.1 报文功能

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l 成功的交易通过此接口通知商户。

3.8.5.2 请求报文说明

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

 

参考b6的返回码

非空

 

RETMSG

错误信息

C(1,256)

 

可空

 

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

 

MOBILE

手机号/小灵通

C (1,13)

小灵通带区号，不带括号，减号

可空

 

AMOUNT

金额

N(1,12)

整数，单位分

非空

 

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

 

FINTIME

完成时间

C(14)

 

非空

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

 

BATCHID

交易流水号

C(60)

原请求报文中的交易流水REQ_SN

必填

 

SN

记录序号

C(4)

原交易的记录序号SN，单笔默认为0

必填

 

POUNDAGE

手续费

N(12)

整数，单位分

可空

 

USERCODE

自定义用户号

C(20)

原交易的CUST_USERID

可空

 

TRXTYPE

交易类型

C(1)

0差错类交易 1普通交易

可空

 

MERID

商户号

C(15)

商户号

非空

 

TRXCODE

交易代码

C(1, 20)

 

必填

 

FUNDIN_ID

汇入金唯一识别码

C(1, 64)

 

可空

 

FROM_ACCT_NAME

汇入金来款户名

C(1, 128)

 

可空

 

SUMMARY

摘要

C(1, 120)

 

可空

 

REMARK

备注

C (1,50)

备注

可空

 

VOUCHERNO

银行流水号

C(1,16)

 

可空

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为 账号|手机号|金额|交易流水号|记录序号|手续费

必填

 

 

3.8.5.3 响应报文说明

商户系统返回一行内容

SUCCESS或者ERROR

 

3.8.5.4 例子

http://172.16.1.12:8282/techsp/helper/basicdef/tlt/basicdef.html?RETCODE=0000&RETMSG=%E5%A4%84%E7%90%86%E6%88%90%E5%8A%9F&ACCOUNT_NO=62178808000104315861&MOBILE=&AMOUNT=20000&SETTDAY=20180511&FINTIME=20180511151749&SUBMITTIME=20180511151747&BATCHID=200604000004497-1526023069833&SN=0&POUNDAGE=0&USERCODE=252523524253xx&TRXTYPE=1&SIGN=3d6a1ec6ee95594aa710cf4445c17bcc99021c6b1cb73dfaa561188930f796b59c2ad037d1df7a5a25a93fac54d516144d12cd74197023ef8bed13689784a814862887fb2bcded96e67ea1c1412ede2030680b6116bf86ea6c38dd25ee62ef0eded40a1aeda962a04ef37bbf58e933924721b52ddec7c7f6297da890dfd6579e35f46c63d2bde5ba736a6578dba25160bbb5a0a9018e910f636a895e42af2ab9629f2a2d25e13d4ccc53db97c1b14509e4d753856bbcc33434e9812b1e72875720d70d44975e5fa893d6f3df9d72cdf46d601fc403da2710bc5252ed42076cd400c8a9081855e052a0f6b02179618147c1fa7d5894ad593d44a3b137a9dd01ee

 

3.8.6 代收付单笔失败交易结果通知

3.8.6.1 报文功能

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

l失败的交易通过此接口通知商户；

交易类型：实时收款、实时付款、批量收款（对应的明细交易）、批量付款（对应的明细交易），退款。

3.8.6.2 请求报文

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

参照交易明细中的返回码

非空

 

RETMSG

错误信息

C(1,256)

 

可空

 

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

 

MOBILE

手机号/小灵通

C (1,13)

小灵通带区号，不带括号，减号

可空

 

AMOUNT

金额

N(1,12)

整数，单位分

非空

 

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

 

FINTIME

完成时间

C(14)

 

非空

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

 

BATCHID

交易流水号

C(60)

原请求报文中的交易流水REQ_SN

必填

 

SN

记录序号

C(4)

原交易的记录序号SN，单笔默认为0

必填

 

POUNDAGE

手续费

N(12)

整数，单位分

可空

 

USERCODE

用户代码

C(20)

商户客户ID

可空

 

TRXTYPE

交易类型

C(1)

0差错类交易 1普通交易

可空

 

MERID

商户号

C(15)

商户号

非空

 

REMARK

备注

C (1,50)

备注

可空

 

VOUCHERNO

银行流水号

C(1,16)

 

可空

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为 返回码|账号|手机号|金额|交易流水号|记录序号|手续费

必填

 

 

3.8.6.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

3.8.6.4 例子

http://172.16.1.12:8282/techsp/helper/basicdef/tlt/basicdef.html?RETCODE=3008&RETMSG=%E4%BD%99%E9%A2%9D%E4%B8%8D%E8%B6%B3&ACCOUNT_NO=62178808000104315861&MOBILE=&AMOUNT=20000&SETTDAY=20180511&FINTIME=20180511170709&SUBMITTIME=20180511170708&BATCHID=200604000004497-1526029630044&SN=0&POUNDAGE=0&USERCODE=252523524253xx&SIGN=5a685ec9226a7cbbe8484e3d74b9e2a1d8e77716036e0985a21a6dcb5b4de124ba16208f032f08c186acef7c58735a6785e8ab0629c1f508210c1d5d6811a958c872017a5c3674a2a2124f53adfad08c08fc2b9dc2b39389287040d1c6172b220c9bec9a787853c301a59b62ec9187cf7103fae29622cc9d8a6f8ab6a7d10fa229b38190ca2240be4ef34669d6f0746d43142744b8e289b793a8942494223f98ce1f0670cf4b6570afc9fb0968d9977234324ff31f345c80340de7316889285abcec7a4c9b7b9a3a9a4bfd77a13910d6be2bbf794f118872dd5b80dbf2ff06c9cf34d5598a16f411ccabed7105c83d97d0b6ccf4745fcafdd7e4e89f4a68848e

 

 

3.8.7 解约通知(310005)

3.8.7.1 报文说明

l报文通讯方式：HTTP/HTTPS+GET方式，商户需提供接收通知的URL。

3.8.7.2 请求报文

URL参数名

说明

类型

取值

可空

备注

ACCTNO

银行账号

C(1,32)

协议解约的银行账号

非空

 

AGRTYPE

协议类型

C（2）

00：商委协议 01:快捷协议 02:新代收协议

非空

 

MERID

商户号

C(15)

 

非空

 

TRXCODE

交易类型

C (6)

310005

非空

 

BUSINESSCODE

业务代码

C（6）

商委签约时不为空

可空

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容 商委：商户号|银行账号|业务代码

快捷：商户号|银行账号

非空

 

 

 

3.8.7.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

3.8.8 余额告警通知(110000)

3.8.8.1 报文说明

l报文通讯方式：POST方式，商户需提供接收通知的URL。

3.8.8.2 请求报文

URL参数名

说明

类型

取值

可空

备注

MERID

商户号

C(15)

x8;分配的商户号

非空

 

TRXCODE

交易类型

C (6)

110000

非空

 

AVAILABLE_BALANCE

可用余额

C(1,20)

 

非空

单位：元

WARN_BALANCE

告警余额阀值

C(1,20)

 

非空

单位：元

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为： 商户号|交易类型|可用余额|告警余额阀值

 

非空

 

 

3.8.8.3 响应报文

商户系统返回一行内容

SUCCESS或者ERROR

huangwg 2025年4月2日 16:22 1038 0 条评论 收藏文档