收付通API

通联核心产品文档中心

3.8异步通知接口组

目录

3.8异步通知接口组

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

超时时间为2.5秒 ）。签名算法支持国密或rsa，默认rsa，如需国密，可登陆后台 运行参数，通知参数进行配置。

3.8.1 退票通知

3.8.1.1 接口功能

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

专门针对跨行代付交易，当发生退票情况时，通过该接口将退票相关信息（包含原交易信息）通知给商户

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 接口功能

采用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,46)

 

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,46)

 

可空

 

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,46)

 

可空

 

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

3.8.9 结算交易通知

3.8.9.1 接口功能

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

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

3.8.9.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,46)

C

SIGN

签名

 

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

M

 

 

huangwg 2025年10月21日 14:19 2596 0 条评论 收藏文档