收付通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 报文功能

每次请求只有一笔交易，请求都是实时处理（即时到账）并返回最终结果，但不排除存在银行不能在规定时间内处理完成，这时通联返回接收结果超时（处理中的状态），银行处理完成通联会实时更新结果，商户发起交易查询更新交易结果；（针对持卡人自发放款请求操作，如系统定时任务执行调用批量接口）

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银行卡，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 2024年8月19日 16:45 1068 0 条评论 收藏文档