收付通API

通联核心产品文档中心

3.2批量代收付报文组

目录

3.2批量代收付报文组

报文调用关系

3.1.1批量代收(100001)

3.1.2.1 报文功能

批量代收实时返回只是通联受理成功，不代表该交易的已经有最终状态，受理成功只是处理中状态，非实时的，处理时效根据交易笔数限制，要发起交易查询。

建议批量发起的交易笔数不超过2000笔，还有批次中不能存在相同卡号的交易（不能有一个批次只有一笔交易明细情况）。

3.1.2.2 请求报文

 

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100001

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

 

 

BODY/

 TRANS_SUM

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码,接入生产前，业务人员会提供，测试时，可以从该文档3.1对应的业务吗中随便选一个

M

 

 

MERCHANT_ID

商户代码

C(10,15)

商户ID，十位或十五位

M

 

 

SETTDAY

清算日期

C(8)

仅供特殊商户使用,普通商户不用理会该字段

C

不推荐使用

 

SUBMIT_TIME

提交时间

C(14)

YYYYMMDDHHMMSS

M

 

 

TOTAL_ITEM

总记录数

C(1,4)

 

M

 

 

TOTAL_SUM

总金额

C(1,12)

整数，单位分

M

 

 

BODY/

 TRANS_SUM/

LEDGERS/LEDGERDTL

SN

记录序号

C(1,4)

分账记录序号

C

无分账需求，无需该节点

 

MERCHANT_ID

分账商户号

C(10,15)

商户ID

C

 

AMOUNT

分账金额

C(1,12)

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

C

 

TYPE

分账类型

C(1)

只支持按比例分账，上送值为1,联系客户经理配置

C

 

BODY/

TRANS_SUM/

DETAIL_LEDGERS/LEDGERDTL

SN

分账序号

C(1,4)

 

C

 

 

MERCHANT_ID

商户号

C(10,15)

 

C

 

 

AMOUNT

金额

N(1,12)

 

C

 

 

TYPE

分账类型

C(1)

 

C

 

 

DETAIL_SN

分账明细对应的sn

C(1,4)

 

C

 

 

BODY/

 TRANS_DETAILS/

TRANS_DETAIL

SN

记录序号

C(1,4)

同一个请求内必须唯一。建议从0001开始递增,交易结果查询时，该字段会原样返回

M

 

 

E_USER_CODE

用户编号

C(1,20)

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

c

 

 

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

C

 

ACCOUNT_TYPE

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

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

 

BANK_NAME

开户行名称

C(1,60)

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

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(128)

供商户填入备注信息。

M

 

 

SETTGROUPFLAG

分组清算标志

C(1,30)

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

M

 

 

SUMMARY

交易附言

C(1,140)

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

M

 

 

UNION_BANK

支付行号

C(1,12)

支付行号

M

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

 

NOTIFYURL

通知地址

C (200)

 

C

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

 

3.1.2.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100001

M

详见报文头说明

VERSION

版本号

C(2)

05

M

 

DATA_TYPE

数据格式

C(1)

2

M

 

REQ_SN

请求流水号

C(0,60)

 

M

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

RET_CODE

返回代码

C(4)

参考附录B2与B6

M

 

ERR_MSG

错误信息

C(1,256)

 

M

 

SIGNED_MSG

签名信息

C

 

M

 

BODY/

 RET_DETAILS/

RET_DETAIL

SN

记录序号

C(4)

原 请求报文中的SN字段值，原封不动的返回

C

 

RET_CODE

返回码

C(4)

参考附录B2与B6

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

3.1.2.4 例子

请求报文：<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100001</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-1525945348500</REQ_SN>
<SIGNED_MSG>7c43a1d2164eff9a74f0fc63cc7c9ad4f17e1ffd0384a73cf9fb9a901f3e62734c3a17960fb21ee12674224a2403f1632f42e416f467bcfd776c4f400ad04574236a60bc9f276c5f0671cb5081eb59feb53ba524833862240a7b0481e4703cd39b07b2df40d41574d6b4451e5a97224e418c3b6838c5df8082a4a62b4e6a7235</SIGNED_MSG>
</INFO>
<BODY>
<TRANS_SUM>
<BUSINESS_CODE>19900</BUSINESS_CODE>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<SUBMIT_TIME></SUBMIT_TIME>
<TOTAL_ITEM>2</TOTAL_ITEM>
<TOTAL_SUM>4000</TOTAL_SUM>
<SETTDAY></SETTDAY>
</TRANS_SUM>
<TRANS_DETAILS>
<TRANS_DETAIL>
<SN>001</SN>
<E_USER_CODE></E_USER_CODE>
<BANK_CODE>0103</BANK_CODE>
<ACCOUNT_TYPE></ACCOUNT_TYPE>
<ACCOUNT_NO>***</ACCOUNT_NO>
<ACCOUNT_NAME>黄群芳</ACCOUNT_NAME>
<PROVINCE></PROVINCE>
<CITY></CITY>
<BANK_NAME></BANK_NAME>
<ACCOUNT_PROP>0</ACCOUNT_PROP>
<AMOUNT>2000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<PROTOCOL></PROTOCOL>
<PROTOCOL_USERID></PROTOCOL_USERID>
<ID_TYPE></ID_TYPE>
<ID></ID>
<TEL></TEL>
<CUST_USERID></CUST_USERID>
<REMARK></REMARK>
<SETTACCT>2000019999</SETTACCT>
<SETTGROUPFLAG></SETTGROUPFLAG>
<SUMMARY></SUMMARY>
<UNION_BANK></UNION_BANK>
</TRANS_DETAIL>
<TRANS_DETAIL>
<SN>002</SN>
<E_USER_CODE></E_USER_CODE>
<BANK_CODE>0104</BANK_CODE>
<ACCOUNT_TYPE></ACCOUNT_TYPE>
<ACCOUNT_NO>***</ACCOUNT_NO>
<ACCOUNT_NAME>黄群芳</ACCOUNT_NAME>
<PROVINCE></PROVINCE>
<CITY></CITY>
<BANK_NAME></BANK_NAME>
<ACCOUNT_PROP></ACCOUNT_PROP>
<AMOUNT>2000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<PROTOCOL></PROTOCOL>
<PROTOCOL_USERID></PROTOCOL_USERID>
<ID_TYPE></ID_TYPE>
<ID></ID>
<TEL></TEL>
<CUST_USERID></CUST_USERID>
<REMARK></REMARK>
<SETTACCT>200001</SETTACCT>
<SETTGROUPFLAG></SETTGROUPFLAG>
<SUMMARY></SUMMARY>
<UNION_BANK></UNION_BANK>
</TRANS_DETAIL>
</TRANS_DETAILS>
</BODY>
</AIPG>
返回报文:
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100001</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1525945348500</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>受理成功</ERR_MSG>
<SIGNED_MSG>a1f8460ea7589ceaa67020fd0f4b65943b7e2188f9e1c13d22d10a6bfc1b09fc76c6809eabe09bbf820ef6ac7c261057254283b91520167c5ddafdce17f2b6ad4ac9e01b7c8a55dc460afe1590a292c39384f4bfed2d85e6def9bd6f3a41099e3cbc89a3af609b0ff0032c19a14c3fdaaa84f3bff0e67d0cc3cb83a6dbfdd98f71b933fc1561c0aeab196ec7f41cadbc9dec22f0390d0a536aca2039bfa6de51c3f6cb5b58f003495ffdc97e3c1f8ec5eb46c5efc2fbe9fab364dc7ccf5bdcbc74dde1aab43fe59c5eb889d1d11a463a5c63a1c9b3799317d6616556f97b8c30d4099e75c3b984a2149e3e03841c912a500127628eb32396df5a528ff4cf06df</SIGNED_MSG>
</INFO>
<BODY>
<RET_DETAILS>
<RET_DETAIL>
<SN>001</SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG></ERR_MSG>
</RET_DETAIL>
<RET_DETAIL>
<SN>002</SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG></ERR_MSG>
</RET_DETAIL>
</RET_DETAILS>
</BODY>
</AIPG>

3.2.2批量代付(100002)

3.2.2.1 报文功能

批量代收实时返回只是通联受理成功，不代表该交易的已经有最终状态，受理成功只是处理中状态，非实时的，处理时效根据交易笔数限制，要发起交易查询。

建议批量发起的交易笔数不超过2000笔，还有批次中不能存在相同卡号的交易（不能有一个批次只有一笔交易明细情况）。

3.2.2.2 请求报文

 

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100002

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

 

 

BODY/

 TRANS_SUM

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码,接入生产前，业务人员会提供，测试时，可以从该文档3.2对应的业务吗中随便选一个

M

 

 

MERCHANT_ID

商户代码

C(10,15)

商户ID，十位或十五位

M

 

 

SETTDAY

清算日期

C(8)

仅供特殊商户使用,普通商户不用理会该字段

C

不推荐使用

 

SUBMIT_TIME

提交时间

C(14)

YYYYMMDDHHMMSS

M

 

 

TOTAL_ITEM

总记录数

C(1,4)

 

M

 

 

TOTAL_SUM

总金额

C(1,12)

整数，单位分

M

 

 

BODY/

 TRANS_DETAILS/

TRANS_DETAIL

SN

记录序号

C(1,25)

同一个请求内必须唯一。建议从0001开始递增,交易结果查询时，该字段会原样返回

M

 

 

E_USER_CODE

用户编号

C(1,20)

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

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

对公付款需要上送

 

BANK_NAME

开户行名称

C(1,60)

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

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)

 

C

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

 

TEL

手机号/小灵通

C(13)

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

C

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

 

CUST_USERID

自定义用户号

C(128)

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

C

 

 

SETTACCT

本交易结算户

C(32)

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

C

 

 

REMARK

备注

C(128)

供商户填入备注信息。

C

 

 

SETTGROUPFLAG

分组清算标志

C(1,30)

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

M

 

 

SUMMARY

交易附言

C(1,140)

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

C

 

 

UNION_BANK

支付行号

C(1,12)

支付行号

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

 

3.2.2.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

100002

M

详见报文头说明

VERSION

版本号

C(2)

05

M

 

DATA_TYPE

数据格式

C(1)

2

M

 

REQ_SN

请求流水号

C(0,60)

 

M

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

RET_CODE

返回代码

C(4)

参考附录B2与B6

M

 

ERR_MSG

错误信息

C(1,256)

 

M

 

SIGNED_MSG

签名信息

C

 

M

 

BODY/

 RET_DETAILS/

RET_DETAIL

SN

记录序号

C(4)

原 请求报文中的SN字段值，原封不动的返回

C

 

RET_CODE

返回码

C(4)

参考附录B2与B6

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

3.2.2.4 例子

请求报文：
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100002</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-1526009797922</REQ_SN>
<SIGNED_MSG>2a4124ef6f451e9d08054dd5ef47783190d140d4431e0ffe274641fb9997c55895cf68d5ac30e6f7a13e615144bdf7a0d24f98a98985b013786ff8ebb6a7e4f2429e29961f0ac3fcb1889d618839b5bdaea0e3cf831dcdf8b9b47c81139a24d1151b6ed46c5e2fea35fcbdebee04b324996aa6a9a5e9aa0959405ff20fa15905</SIGNED_MSG>
</INFO>
<BODY>
<TRANS_SUM>
<BUSINESS_CODE>09900</BUSINESS_CODE>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<SUBMIT_TIME></SUBMIT_TIME>
<TOTAL_ITEM>2</TOTAL_ITEM>
<TOTAL_SUM>4000</TOTAL_SUM>
<SETTDAY></SETTDAY>
</TRANS_SUM>
<TRANS_DETAILS>
<TRANS_DETAIL>
<SN>001</SN>
<E_USER_CODE></E_USER_CODE>
<BANK_CODE>0103</BANK_CODE>
<ACCOUNT_TYPE></ACCOUNT_TYPE>
<ACCOUNT_NO>****</ACCOUNT_NO>
<ACCOUNT_NAME>黄群芳</ACCOUNT_NAME>
<PROVINCE></PROVINCE>
<CITY></CITY>
<BANK_NAME></BANK_NAME>
<ACCOUNT_PROP>0</ACCOUNT_PROP>
<AMOUNT>2000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<PROTOCOL></PROTOCOL>
<PROTOCOL_USERID></PROTOCOL_USERID>
<ID_TYPE></ID_TYPE>
<ID></ID>
<TEL></TEL>
<CUST_USERID></CUST_USERID>
<REMARK></REMARK>
<SETTACCT>2000019999</SETTACCT>
<SETTGROUPFLAG></SETTGROUPFLAG>
<SUMMARY></SUMMARY>
<UNION_BANK></UNION_BANK>
</TRANS_DETAIL>
<TRANS_DETAIL>
<SN>002</SN>
<E_USER_CODE></E_USER_CODE>
<BANK_CODE>0104</BANK_CODE>
<ACCOUNT_TYPE></ACCOUNT_TYPE>
<ACCOUNT_NO>*****</ACCOUNT_NO>
<ACCOUNT_NAME>黄群芳</ACCOUNT_NAME>
<PROVINCE></PROVINCE>
<CITY></CITY>
<BANK_NAME></BANK_NAME>
<ACCOUNT_PROP></ACCOUNT_PROP>
<AMOUNT>2000</AMOUNT>
<CURRENCY>CNY</CURRENCY>
<PROTOCOL></PROTOCOL>
<PROTOCOL_USERID></PROTOCOL_USERID>
<ID_TYPE></ID_TYPE>
<ID></ID>
<TEL></TEL>
<CUST_USERID></CUST_USERID>
<REMARK></REMARK>
<SETTACCT>200001</SETTACCT>
<SETTGROUPFLAG></SETTGROUPFLAG>
<SUMMARY></SUMMARY>
<UNION_BANK></UNION_BANK>
</TRANS_DETAIL>
</TRANS_DETAILS>
</BODY>
</AIPG>
返回报文:
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>100002</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526009797922</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>受理成功</ERR_MSG>
<SIGNED_MSG>6f9ff0496d638783d3d61332d0208b3c9974b29c0b0ee9d2f3768cc3e5804cdea3077741557a1fd177ec4513704ba5eb06871f3589878fc2337752f4948aa1ee8dd35f2d91ec23c1e23a2f8514371d9c46c55e3c441fcfd895317e317037dd62cec6d7889ef5900618549ed618f93bba283c4ccd6920f996fba12c5a5e07b7d8bc3c39ba7a58a62068c84df9fb5aa8356127b65acdac31152322067994be9d9a213694528a4195cc09b7de26ed108d0f347929bfb0c454816630d9f2635b2d3a5db530a40bd002eaf2574e6407eb3eadb30cef084a196b786a006dc9a853209ae3040468d69dac7d4d707b8cdf675b60f914a2196615f0e4c78b551783d3ba99</SIGNED_MSG>
</INFO>
<BODY>
<RET_DETAILS>
<RET_DETAIL>
<SN>001</SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG></ERR_MSG>
</RET_DETAIL>
<RET_DETAIL>
<SN>002</SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG></ERR_MSG>
</RET_DETAIL>
</RET_DETAILS>
</BODY>
</AIPG>
huangwg 2025年4月16日 10:58 1159 0 条评论 收藏文档