收付通API

通联核心产品文档中心

3.3收付通单笔实时代收付接口组

目录

3.3单笔实时代收付接口组

接口调用关系

3.3.1单笔实时代收(100011)

3.3.1.1 接口功能

  • 每次请求仅支持处理一笔代收交易，交易实时处理且通常即时到账并返回最终结果，满足商户对实时扣款的需求（如持卡人主动发起的缴费、充值等扣款操作）。
  • 若遇银行在规定时间内无法完成处理的特殊情况，通联会返回“接收结果超时”的中间状态，待银行处理完成后通联会实时更新交易结果，商户需通过后续交易查询接口获取并更新最终结果。
  • 不允许对同一账户并发发起代收请求，避免因并发操作导致账户状态异常或交易数据混乱，保障交易安全性和准确性。
  • 支持分账功能，商户可根据业务需求配置分账规则，在代收交易完成后按设定的分账金额或比例将资金分配给指定分账商户。

3.3.1.2 请求报文

 

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100011

M

详见报文头说明

 

VERSION

版本号

C(2)

06

M

 

 

DATA_TYPE

数据格式

C(1)

2

M

 

 

LEVEL

处理级别

N(1)

5

M

 

 

MERCHANT_ID

商户号

C(10,20)

 

M

 

 

USER_NAME

用户名

C(1,20)

 

M

 

 

USER_PASS

用户密码

C(1,20)

 

C

 

不校验，（无需填写或可置空）

REQ_SN

请求流水号

C(0,60)

 

M

 

商户号+商户自定义不重复流水号

SIGNED_MSG

签名信息

C

 

M

 

 

 

TRANS

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

 

 

MERCHANT_ID

商户代码

C(10,15)

商户ID

M

 

 

SUBMIT_TIME

提交时间

C (14)

YYYYMMDDHHMMSS

C

 

 

E_USER_CODE

用户编号

C(1,20)

客户编号,开发人员可当作备注字段使用

c

 

 

VALIDATE

有效期

C (8)

YYYYMMDD，用于信用卡

C

 

 

CVV2

信用卡CVV2

C (3)

仅用于信用卡

C

 

 

ACCOUNT_TYPE

账号类型

C(2)

00银行卡，02信用卡。不填默认为银行卡00。

06:银联token账号

C

 

 

BANK_CODE

银行代码

C(8)

银行代码，存折必须填写。参见附录A.3银行代码

C

存折必填，银行卡视情况填写，详情见2.9.4银行代码说明

针对账户类型传06的，必须上送银行代码

无法通过银联卡bin识别出银行代码的，都需要上送银行代码

ACCOUNT_NO

账号

C(1,32)

银行卡或存折号码

M

 

 

ACCOUNT_NAME

账号名

C(1,60)

银行卡或存折上的所有人姓名。

M

 

 

PROVINCE

开户行所在省

C(1,20)

不带“省”或“自治区”，如 广东，广西，内蒙古等。建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。

C

对公账号需要上送

 

CITY

开户行所在市

C (1,20)

不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。

C

对公账号需要上送

 

ACCOUNT_PROP

账号属性

C(1)

0私人，1公司。不填时，默认为私人0。

M

 

 

AMOUNT

金额

N(1,12)

整数，单位分

M

 

 

CURRENCY

货币类型

C(3)

人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。

C

 

 

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

C

看具体渠道，有些必须上送，联系客户经理

 

ID

证件号

C(1,22)

 

M

看具体渠道，有些必须上送，联系客户经理

 

TEL

手机号/小灵通

C(13)

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

C

看具体渠道，有些必须上送，联系客户经理

 

CUST_USERID

自定义用户号

C(128)

商户自定义的用户号，开发人员可省略该字段，也可以当作备注字段使用,该字段会在对账文件中原样返回

C

 

 

SETTACCT

本交易结算户

C(32)

结算到商户的账户，不需分别清算时不需填写。

C

 

 

REMARK

备注

C(50)

供商户填入备注信息。

C

 

 

SETTGROUPFLAG

分组清算标志

C(1,30)

仅供特殊商户使用，普通商户不要使用该字段，可忽略

C

 

 

SUMMARY

交易附言

C(1,140)

填入网银的交易备注,可以在网银明细中查询到该字段信息，但部分银行可能不支持

C

 

 

NOTIFYURL

通知地址

C (200)

 

C

交易无论成功还是失败都会通知到上送的地址，通知格式参考3.8.5代收付单笔成功交易结果通知

 

LEDGERS/

LEDGERDTL

SN

记录序号

C(1,4)

分账记录序号

C

无分账需求，无需该节点

 

MERCHANT_ID

分账商户号

C(10,15)

商户ID

C

 

AMOUNT

分账金额

C(1,12)

整数，单位分TYPE为0时必填（分给该商户多少钱）

C

 

TYPE

分账类型

C(1)

0按金额分账 1按比例分账 默认0（如果按照比例分的话是后台固定配置的，不需要上送，分账金额可以为空，如需配置，请联系通联客户经理提需求配置）

C

 

3.3.1.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100011

M

详见报文头说明

VERSION

版本号

C(2)

06

M

 

DATA_TYPE

数据格式

C(1)

2

M

 

REQ_SN

请求流水号

C(0,60)

 

M

商户号+商户自定义不重复流水号

RET_CODE

返回代码

C(4)

参考附录B3与B6

M

 

ERR_MSG

错误信息

C(1,256)

 

M

 

SIGNED_MSG

签名信息

C

 

M

 

TRANSRET

RET_CODE

返回码

C(4)

参考附录B3与B6

C

 

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

VOUCHERNO

银行流水号

C(1,46)

 

C

VERSION为06才返回该值

3.3.1.4 例子

请求报文
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100011</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1525923303530</REQ_SN>
<SIGNED_MSG>59c0d5ec49866bb2240af577f871c8bb38f22f176eae0a1e7567ad62f356ef59d9f71fd725c1aa0db2802a58956a0c3e57573cbd4dcc6dc2bb39843a755c71417624708801c73dd995b7c97faae63c09c85a21c8640b4c95f1db9ed3ded215017043e31331d27d017e20efc56a17ad396e3aef73d1034c01ab28bfc3af937ac9</SIGNED_MSG>
</INFO>
<TRANS>
<BUSINESS_CODE>19900</BUSINESS_CODE>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<SUBMIT_TIME>20180510113503</SUBMIT_TIME>
<BANK_CODE>0302</BANK_CODE>
<ACCOUNT_NO>62178808000104315861</ACCOUNT_NO>
<ACCOUNT_NAME>zhang000001</ACCOUNT_NAME>
<ACCOUNT_PROP>0</ACCOUNT_PROP>
<AMOUNT>20000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<ID_TYPE>0</ID_TYPE>
<ID>120221198606121502</ID>
<TEL></TEL>
<CUST_USERID>252523524253xx</CUST_USERID>
</TRANS>
</AIPG>
返回报文
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100011</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1525923303530</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>处理成功</ERR_MSG>
<SIGNED_MSG>9b08c64f7894ce6ae21a5f598aa6e6bfa064deac1a19cfc3b758dab60144445eb0db20dbfbe9301089eaf3d681c5046a729a1a4a332a034f4c4508d0b566debc56081d2b909afb79de27944061794b7a981e0107b96102e93c4c8b6c7dcc5ed2f272361c88598f2887dd7442819eb71712c4fc5e276f7b99055cd75a5fcef4ee9be2e6fdcc84450a9563c76d18ada329ea5235f32e4a7966eb44ef72d2d44ef76268c509da267526e8b7f13bbf5ea37f71b2586d80e07a1e0acb62f50f025246a690f2175e0b295140e790a2b055fc0c2387a4d9b7b39b8bace72285600c0227eca7c81d147a3a7d422b1774158e85030336366acce37d4092dc9bbf525a9113</SIGNED_MSG>
</INFO>
<TRANSRET>
<RET_CODE>0000</RET_CODE>
<SETTLE_DAY>20180510</SETTLE_DAY>
<ERR_MSG>处理成功</ERR_MSG>
</TRANSRET>
</AIPG>

3.3.2单笔实时代付(100014)

3.3.2.1 接口功能

  • 每次请求仅处理一笔代付交易，交易实时处理且通常即时到账并返回最终结果，适用于商户向持卡人发起的放款操作（如薪资发放、佣金结算、退款等自发放款场景）。
  • 若银行未能在规定时间内完成处理，通联会返回“接收结果超时”的中间状态，待银行处理完成后，通联会实时更新交易结果，商户需通过交易查询接口获取并同步最终结果，确保交易状态准确。
  • 针对不同账户类型（私人/公司）和卡类别（一类卡/二类卡/三类卡）有差异化字段要求，例如对公付款需上送开户行所在省、市、开户行名称、支付行号等信息，二类户付款需明确填写卡类别字段，保障不同场景下代付交易的合规性和准确性。
  • 支持灵活的代付划账类型配置，可选择“主动划账”（默认从余额户出资）或“委托扣款”（默认从对公户出资，需先申请配置接口），满足商户不同的资金出资需求；同时支持客户自定义手续费（在商户配置特殊计费时生效），适配多样化的计费场景。
  • 交易结果会实时通知至商户上送的NOTIFYURL地址（无论成功或失败），便于商户及时获取交易状态并进行后续业务处理，同时支持自定义用户号字段，该字段会在对账文件中原样返回，方便商户对账和用户关联管理。

3.3.2.2 请求报文

 

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100014

M

详见报文头说明

 

VERSION

版本号

C(2)

06

M

 

 

DATA_TYPE

数据格式

C(1)

2

M

 

 

LEVEL

处理级别

N(1)

5

M

 

 

MERCHANT_ID

商户号

C(10,20)

 

M

 

 

USER_NAME

用户名

C(1,20)

 

M

 

 

USER_PASS

用户密码

C(1,20)

 

C

 

不校验，（无需填写或可置空）

REQ_SN

请求流水号

C(0,60)

 

M

 

商户号+商户自定义不重复流水号

SIGNED_MSG

签名信息

C

 

M

 

 

 

TRANS

 

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

 

 

MERCHANT_ID

商户代码

C(10,15)

商户ID

M

 

 

SUBMIT_TIME

提交时间

C (14)

YYYYMMDDHHMMSS

C

 

 

E_USER_CODE

用户编号

C(1,20)

客户编号,开发人员可当作备注字段使用

c

 

 

VALIDATE

有效期

C (8)

YYYYMMDD，用于信用卡

C

 

 

CVV2

信用卡CVV2

C (3)

仅用于信用卡

C

 

 

ACCOUNT_TYPE

账号类型

C(2)

00银行卡，01存折，

02信用卡。不填默认为银行卡00。

06:银联token账号

C

 

 

BANK_CODE

银行代码

C(8)

银行代码，存折必须填写。参见附录A.3银行代码

C

存折必填，银行卡视情况填写，详情见2.9.4银行代码说明

针对账户类型传06的，必须上送银行代码

无法通过银联卡bin识别出银行代码的，都需要上送银行代码

BANK_NAME

开户行名称

C(1,60)

开户行详细名称，也叫网点，如 中国建设银行广州东山广场分理处。

C

对公付款需要上送

 

ACCOUNT_NO

账号

C(1,32)

银行卡或存折号码

M

 

 

ACCOUNT_NAME

账号名

C(1,60)

银行卡或存折上的所有人姓名。

M

 

 

PROVINCE

开户行所在省

C(1,20)

不带“省”或“自治区”，如 广东，广西，内蒙古等。建议根据后附的中国邮政区号表内的“省洲名称”列的内容填写。

C

对公付款需要上送

 

CITY

开户行所在市

C (1,20)

不带“市”，如 广州，南宁等。 如果是直辖市，则填区，如北京（市）朝阳（区）。 建议根据后附的中国邮政区号表内的“地区名称”列的内容填写。

C

对公付款需要上送

 

ACCOUNT_PROP

账号属性

C(1)

0私人，1公司。不填时，默认为私人0。

M

 

 

AMOUNT

金额

N(1,12)

整数，单位分

M

 

 

 CUSTOMIZEDFEE

 客户自定义手续费

N(1,12)

整数，单位分

C

 

 在商户配置了特殊计费时生效

CURRENCY

货币类型

C(3)

人民币：CNY, 港元：HKD，美元：USD。不填时，默认为人民币。

C

 

 

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

C

看具体渠道，有些必须上送，联系客户经理

 

ID

证件号

C(1,22)

 

C

看具体渠道，有些必须上送，联系客户经理

 

TEL

手机号/小灵通

C(13)

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

C

看具体渠道，有些必须上送，联系客户经理

 

CUST_USERID

自定义用户号

C(128)

商户自定义的用户号，开发人员可省略该字段，也可以当作备注字段使用,该字段会在对账文件中原样返回

C

 

 

SETTACCT

本交易结算户

C(32)

结算到商户的账户，不需分别清算时不需填写。

C

 

 

REMARK

备注

C(50)

供商户填入备注信息。

C

 

 

SETTGROUPFLAG

分组清算标志

C(1,30)

仅供特殊商户使用，普通商户不要使用该字段，可忽略

C

 

 

UNION_BANK

支付行号

C(1,12)

支付行号

C

对公付款需要上送

 

SUMMARY

交易附言

C(1,140)

填入网银的交易备注,可以在网银明细中查询到该字段信息，但部分银行可能不支持

C

 

 

NOTIFYURL

通知地址

C (200)

 

C

交易无论成功还是失败都会通知到上送的地址，通知格式参考3.8.5代收付单笔成功交易结果通知

 

ACCOUNT_ATTRB

卡类别

C (20)

1 一类卡 2 二类卡 3 三类卡

C

二类户付款时不能为空

 

FIRST_ACCTNO

一类户账号

N(1,32)

 

C

 

FIRST_ACCTNAME

一类户户名

C (1,60)

 

C

 

PAY_TYPE

代付划账类型

C(1)

0-主动划账

1-委托扣款（ 1 需要先申请配置接口才支持）

C

 

主动划账：付款默认从余额户出资

委托扣款：付款默认从对公户出资

（如不上送取后台配置，如无配置默认主动划款）

3.3.2.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100014

M

详见报文头说明

VERSION

版本号

C(2)

06

M

 

DATA_TYPE

数据格式

C(1)

2

M

 

REQ_SN

请求流水号

C(0,60)

 

M

商户号+商户自定义不重复流水号

RET_CODE

返回代码

C(4)

参考附录B3与B6

M

 

ERR_MSG

错误信息

C(1,256)

 

M

 

SIGNED_MSG

签名信息

C

 

M

 

TRANSRET

RET_CODE

返回码

C(4)

参考附录B3与B6

C

 

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

VOUCHERNO

银行流水号

C(1,46)

 

C

VERSION为06才返回该值

3.3.2.4 例子

请求报文
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100014</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<USER_NAME>20060400000449704</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000004497-1525943815478</REQ_SN>
<SIGNED_MSG>42fe37c650e5aed3979c1fee2c4d669cf019f2be138b3557bf2a29caaf263b728b2aba61c303b89b364529c90e9f6177676ce0c84a5e256a643336e8a7809b185b2171e0869c5e09ccc39f30b4385282270ae6413a1be724d6ab2bfa1f6065b3ea2fd1da99b73e818663a6bdae52602f934941f568ecb63bdee001273d2076b2</SIGNED_MSG>
</INFO>
<TRANS>
<BUSINESS_CODE>09900</BUSINESS_CODE>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<SUBMIT_TIME>20180510171655</SUBMIT_TIME>
<BANK_CODE>0302</BANK_CODE>
<ACCOUNT_NO>62178808000104315861</ACCOUNT_NO>
<ACCOUNT_NAME>zhang000001</ACCOUNT_NAME>
<ACCOUNT_PROP>0</ACCOUNT_PROP>
<AMOUNT>20000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<ID_TYPE>0</ID_TYPE>
<ID>120221198606121502</ID>
<TEL></TEL>
<CUST_USERID>252523524253xx</CUST_USERID>
</TRANS>
</AIPG>
返回报文；
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100014</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1525943815478</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>处理成功</ERR_MSG>
<SIGNED_MSG>500ed54af1c2386e9fa38f6c61c97cf4783991a2f236b5413e9edf068c71f24137aa9a4a9e0720b806fa55ec611057e43eda86bdc0ab08ab82b5e7961afaeae0c1bc40036e8781f6da7957d3beff288fc61082e3319c74b932ffc373040b9a24c5a5cd1e641910f4330fc57faf6ef764d7b4abf17b9cc1f78642c312db4e6103445af2162b6f567126c46a0e1d70ba52c3c935fd2dd27b9e13355d03f8dd8553dabfa75f994fad95f8ff9c956de9d4cef2a85737cc759745ddf9e02ecb9e0a6ef02e50ba26c158c2528cb075c0c1c246bfd0372ca5b7a72ea450957f60be7ae39cfc94b8deaa88ef78cdb2b399ccc92e777ce5378957cfd5c7e337583a1352c2</SIGNED_MSG>
</INFO>
<TRANSRET>
<RET_CODE>0000</RET_CODE>
<SETTLE_DAY>20180510</SETTLE_DAY>
<ERR_MSG>处理成功</ERR_MSG>
</TRANSRET>
</AIPG>
huangwg 2025年10月21日 15:23 2725 0 条评论 收藏文档