收付通API

通联核心产品文档中心

3.1协议支付报文组

目录

3.1协议支付报文组

报文调用关系

挂网协议展示要求

商户对接通联快捷签约接口，需把附录F.关于快捷、代收服务协议资料相关协议挂网展示。

3.1.1协议支付签约短信触发(310001)

3.1.1.1 报文功能

  • 商户端页面设置重新触发短信的间隔时间可以按业界标准的60秒。
  • 短信触发时若头部与明细返回码都返回0000，则会给持卡人发送验证码。
  • 测试环境默认短信验证码为111111。

3.1.1.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310001

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FAGRA

MERCHANT_ID

商户代码

C(10,20)

商户ID

M

  

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

C

 

BANK_CODE

银行代码

C(8)

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

C

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

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

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

M

  

CREDIT_ACCTNO

信用卡卡号

N(1,32)

C

如是一般的协议支付签约可忽略该字段

CREDIT_BANKCODE

信用卡银行代码

N(1,32)

C

如是一般的协议支付签约可忽略该字段,针对账户类型传06的，必须上送银行代码

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

ACCOUNT_PROP

账号属性

C (1)

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

M

 

ID_TYPE

开户证件类型

C (1)

参考A.1证件类型

M

  

ID

证件号

C (1,22)

 

M

  

TEL

手机号/小灵通

C (1,13)

 

M

  

CVV2

CVV2

C (3)

  

C

无需填写

VALIDDATE

有效期

C (4)

  

C

无需填写

CU_PROTOVN

银联协议版本号

C(32)

  

C

  

BNK_PROTOVN

银行协议版本号

C(32)

  

C

  

MC_PROTOVN

商户协议版本

C(31)

  

C

  

MERREM

商户保留信息

C (1,128)

 

C

供商户填入参考信息。若为信用卡，填有效期, 开发人员可省略该字段，也可以当作备注字段使用

EXPIRED

协议失效日

C (8)

yyyyMMdd

C

与单笔最大限额、扣款时间单位、单位时间内扣款次数要素组合上送，要么全送，要么全不上送，如不上送，会根据系统配置的默认值，具体咨询业务。

SINGLEMAXAMT

单笔最大限额

C (1,12)

整数，单位分

C

与协议失效日、扣款时间单位、单位时间内扣款次数要素组合上送，要么全送，要么全不上送，如不上送，会根据系统配置的默认值，具体咨询业务人员。

PERIOD_UNIT

扣款时间单位 

C (2)

 00-年 

01-半年

02-季度

 04-月 

06-周

 07-日

 

 

 

C

与协议失效日、单笔最大限额、单位时间内扣款次数要素组合上送，要么全送，要么全不上送，如不上送，会根据系统配置的默认值，具体咨询业务人员。

MAX_CNT_LIMIT

单位时间内扣款次数

C (2)

 

C

与协议失效日、单笔最大限额、扣款时间单位要素组合上送，要么全送，要么全不上送，如不上送，会根据系统配置的默认值，具体咨询业务人员。

REMARK

备注

C (1,128)

 

C

供商户填入备注信息。

RISKINFO

DEVICE_MODE

设备型号

C(1,256)

设备型号名称

C

  

DEVICE_LANGUAGE

设备语言

C(3)

设备语言,代码遵从ISO639-3标准

C

  

SOURCEIP

客户端IP

C(1,64)

  

C

  

MAC

MAC地址

C(64)

格式00-24-7E-0A-6C-2E或00247e0a6c2e

C

  

DEVICE_ID

设备号

C(129)

建议PC设备采集硬盘序列号、安卓系统设备采集IMEI、IOS设备采集IDFV

C

  

GPS

GPS位置

C(1,32)

经纬度，格式为维度/经度，+表示北纬、东经，-表示南纬、西经 举例：+37.12/-121.23 或者 +37/-121

C

  

DEVICE_NUMBER

SIM卡号码

C(1,32)

存储11位手机号，存在2个通讯设备号码的话，用逗号分隔

C

  

DEVICE_SIMNUM

SIM卡数量

C(1,8)

设备SIM卡数量

C

  

ACCTIDHASH

账户ID

C(1,64)

商户端用户支付时，如处于用户登录状态，提供商户系统中的用户ID

C

  

RISKSCORE

风险评分

C(1,8)

风险等级评分（0-1000分）

C

  

RISKREASONCODE

风险评分的主要原因码

C(1,100)

风险评分的主要原因码

C

  

MCHNTUSRRGSTRTM

收单端用户注册日期

C(14)

收单端用户注册时间，14位时间字符yyyyMMddHHmmss

C

  

MCHNTUSRRGSTREMAIL

收单端用户注册邮箱地址

C(1,64)

收单端用户注册邮箱地址

C

  

RCVPROVINCE

收货省

C(1,4)

收货地-省 上送银联清算地区代码

C

  

RCVCITY

收货市

C(1,4)

收货地-市 上送银联清算地区代码

C

  

GOODSCLASS

商品类别

C(1)

商品类别：0不确定 1虚拟 2非虚拟

C

  

3.1.1.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310001

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B12与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FAGRARET

RET_CODE

返回码

C(4)

参考附录B12与B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

 

3.1.1.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310001</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-1526894131128</REQ_SN>
<SIGNED_MSG>8b11211cc2ffcb6fd227f5bb2081fdbe739e68934cb980886752cc29561c946b50fc207f53bb92fc58db7b0182bbfcf134bd3f2d98771c374d645c10f88faf5b4424f4e9862296d982c0573bfbb98ba61632a0b12415835b178042b2ee7158c2b165e858730eea1a851b5cacef212a7435da7df750e7300b31e2ccafb6949998</SIGNED_MSG>
</INFO>
<FAGRA>
<MERCHANT_ID>2006041*****04497</MERCHANT_ID>
<BANK_CODE>0104</BANK_CODE>
<ACCOUNT_TYPE>00</ACCOUNT_TYPE>
<ACCOUNT_NO>621781*****09949631986</ACCOUNT_NO>
<ACCOUNT_NAME>林三七</ACCOUNT_NAME>
<ACCOUNT_PROP>0</ACCOUNT_PROP>
<ID_TYPE>0</ID_TYPE>
<ID>350101*****811859</ID>
<TEL>13431*****434</TEL>
<REMARK>单笔实时身份验证-备注字段</REMARK>
</FAGRA>
</AIPG>
======================响应内容======================<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310001</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526894131128</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>请求成功</ERR_MSG>
<SIGNED_MSG>3390468f663c6ea2b11652bfda9c5c6e004f1b89f5f3464a244f88cc35b39b5c61b1fb3281f338e964b310ee5f33c09854c82191f29a9edaada0a81ecfcd08ff282c50cde92fc600d8bca7170ba4df14a6d5ad98f22fd261eb3f3ecc8e9d31700a9a9d0bb04afeed504c4683c2b9e01d1f08ec3364cc5627ffa787bbc885797bc3db19be9335024215184716f12f403e261564f1d3f7cc7c0772f8c00c85496f0258eab830e293d025c27f27a327d8a27ca8dfbc896ed0fe9e20ce8d5995fdf8b0ce7539e8abbcfa9f090666459433189d18ec2778ba89e65552a024f89b421a03d2deffff503826633e0461a72afa43f82c1bac8e80ae1299e9e5050a8f4b43</SIGNED_MSG>
</INFO>
<FAGRARET>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>请求成功</ERR_MSG>
</FAGRARET>
</AIPG>

 

3.1.2 协议支付签约(310002)

3.1.2.1 报文功能

  • 短信验证码有效确认时间为2-10分钟。
  • 当客户端没有获取到协议支付签约结果时，可不经过签约短信触发重新发起协议支付签约，但REQ_SN流水号仍需保证不能重复。
  • 同一商户并且同一持卡人，若验证信息正确，则返回的协议号是一样的，返回码也都是0000。

3.1.2.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310002

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

请求流水号

C(0,60)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

FAGRC

MERCHANT_ID

商户代码

C(10,20)

商户ID

M

  

SRCREQSN

原请求流水

C(60)

对应申请 请求报文中的REQ_SN

M

  

VERCODE

验证码

C(6)

短信验证码

M

 

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

  

ACCOUNT_NAME

账号名

C(1,60)

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

C

  

ID

证件号

C (1,22)

 

C

  

TEL

手机号/小灵通

C (1,13)

 

C

  

3.1.2.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310002

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B13与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FAGRCRET

AGRMNO

协议号

C(22)

  

C

成功时协议号不为空

RET_CODE

返回码

C(4)

参考附录B13与B6

C

 

ERR_MSG

错误文本

C(1,256)

  

C

 

3.1.2.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310002</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-1526894231466</REQ_SN>
<SIGNED_MSG>4e0a5009c4f140ad9b04c592313054c97b7a02c3a45e8064e0a6ff927c2c8ac3c19b1338c11291a649c114d1c556183f4cfff91ffe14c4d12ae3af143569a93737d2e01d5befe62a4fd13ec7ef7033d04cbd178a871a0ae211d6a7d7b2d19cf7f0770b9dc64192dfd47f7088e2f70312358595c76db1787eeb988e86b767a746</SIGNED_MSG>
</INFO>
<FAGRC>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<SRCREQSN>200604000004497-1526894131128</SRCREQSN>
<VERCODE>111111</VERCODE>
</FAGRC>
</AIPG>
======================响应内容======================<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310002</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526894231466</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>请求成功</ERR_MSG><SIGNED_MSG>54f30a7c019c7ed33c571a3c3d73db1920f88f2123bce4726c0aa1c5dcb675de02d729d4a7cb6c25a36a7566f1b45f55116406ef0e21af9f9e279578258f7b2530c71509ebef14097f807b825a909fe8c1cd8f182340b773223e3b35981d469eec879e09198a29c6c4671c5177507c3913cd6d524e04d250158685aa9d1bfac4784739aace19a788c92ef41fdf3527c46f7f24cffa4583bae39085528fcdba7ea8e05abca538a368c595707728a08f5337c7912c4d127e9a2e76f08dc87df03d0d972a1b1636916e3ea7845842ba2573b88ce73e61796b81438566cd4ffcc4dab9574582a2d7aed4ffad661949ec1244b00a665ac0751fbacc2935bf14931384</SIGNED_MSG>
</INFO>
<FAGRCRET>
<AGRMNO>AIP198611*****0001126</AGRMNO>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>验证成功</ERR_MSG>
</FAGRCRET>
</AIPG>

3.1.3协议支付解约(310003)

3.1.3.1 报文功能

3.1.3.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310003

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

请求流水号

C(0,60)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

FAGRCNL

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

ACCOUNT_NO

账号

C(32)

借记卡或信用卡

C

 账号和协议号其中一个必填

AGRMNO

协议号

C(22)

签约时返回的协议号

M

协议号规则为：AIP+卡号后四位+YYMMDD+9位流水 (上送了协议号优先按协议号查，只有卡号，按商户号加卡号纬度查）

3.1.3.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310003

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B14与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FAGRCNLRET

RET_CODE

返回码

C(4)

参考附录B14与B6

C

 

ERR_MSG

错误文本

C(1,256)

  

C

 

3.1.3.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310003</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-1526894751771</REQ_SN>
<SIGNED_MSG>00a11bff89edc64998580c4b2f727c0227f2a10d8c15d816da7c11beb22ea344fbd8edd27264a987910a30377c92b0fc767215b4e35916a2c3261c1e717ffdd5af00e34db48b9199cc14e3ffc366978b3680702ec612b65bb1f872c058b8b2bd676500a96494a2ec8d0e435a05cca4c760ed8a3472eb89c3327fb83e3d1a3a7c</SIGNED_MSG>
</INFO>
<FAGRCNL>
<MERCHANT_ID>200604000004497</MERCHANT_ID>
<AGRMNO>AIP1986180521000001134</AGRMNO>
</FAGRCNL>
</AIPG>
======================响应内容======================<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310003</TRX_CODE>
<VERSION>04</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000004497-1526894751771</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>请求成功</ERR_MSG>
<SIGNED_MSG>3f3873e3948e0a625cb14a9d363688a185ee402e93cd7d377cbc7d96c30c9d90d9f78244a9b45798420ed020f42ed1bb424d7350cc09c0567452d7271c97eccf64fa08ba9c9dd0ab0c8eedce058a75cb390259c514018204fbfa0380fb89cba23a4eebb9d80c9e696b57233ada3745bcb5356b0d1680b998942d24c4d8c825e0e43919681bea665ba5e0b7c0fa14a66b831a31069045d0c7bb3f09e22b27b6c15b4a4eb976a523238893322fb6bf53753e3f025b7a7d829a6a377365ebe9d9e5f91f5329076327d14160bac26cbb5574cf9f999de80e05a9f1256d27e5c4c282b2d39dc035318e49bb3d511bc0576f3703b8a1b28dd71e17111cd2a8969fc62f</SIGNED_MSG>
</INFO>
<FAGRCNLRET>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>解约成功</ERR_MSG>
</FAGRCNLRET></AIPG>

3.1.4协议支付(310011)

3.1.4.1 报文功能

  • 当持卡人在银行端变更了手机号，或者在网银取消了快捷协议，导致协议无效，则协议支付时会返回3043（未与银行签约）的错误，商户针对该错误码需引导持卡人重新进行签约。（针对持卡人实时发起扣款请求操作，如系统定时任务执行调用批量接口）

3.1.4.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310011

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

  

REQ_SN

请求流水号

C(0,60)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

FASTTRX

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

  

MERCHANT_ID

商户号

C(15)

  

M

  

SUBMIT_TIME

提交时间

C(14)

YYYYMMDDHHMMSS

M

  

AGRMNO

协议号

C(22)

签约时返回的协议号

C

卡号和协议号其中一个必填，优先通过卡号匹配协议号

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

C

 

BANK_CODE

银行代码

C(8)

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

C

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

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

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

  

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

AMOUNT

金额

C(12)

整数，单位分

M

  

CURRENCY

货币类型

C (3)

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

C

 

ID_TYPE

开户证件类型

C (1)

参考A.1证件类型

C

  

ID

证件号

C (1,22)

 

C

  

TEL

手机号/小灵通

C (1,13)

 

C

  

CVV2

CVV2

C (3)

信用卡时必填

C

无需填写

VALIDDATE

有效期

C (4)

信用卡时必填，格式MMYY(信用卡上的两位月两位年)

C

无需填写

CUST_USERID

自定义用户号

C (1,128)

 

C

商户自定义的用户号，开发人员可当作备注字段使用

FEEFLAG

持卡人手续费

C(1)

  

C

0:持卡人承担手续费

1:商户承担手续费

SETTACCT

本交易结算户

C(32)

不同交易想要结算到不同账户，可上送。不需分别结算时不需填写。

C

  

REMARK

备注

C (1,50)

 

C

供商户填入备注信息。

SUMMARY

交易附言

C(1,140)

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

C

  

NOTIFYURL

通知地址

C (200)

 

C

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

LEDGERS/

LEDGERDTL

SN

记录序号

C(1,4)

分账记录序号

C

无分账需求，无需改节点

MERCHANT_ID

分账商户号

C(10,20)

商户ID

C

AMOUNT

分账金额

C(12)

整数，单位分TYPE为0时必填

C

TYPE

分账类型

C(1)

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

C

RISKINFO

DEVICE_MODE

设备型号

C(1,256)

设备型号名称

C

  

DEVICE_LANGUAGE

设备语言

C(3)

设备语言,代码遵从ISO639-3标准

C

  

SOURCEIP

客户端IP

C(1,64)

  

C

  

MAC

MAC地址

C(64)

格式00-24-7E-0A-6C-2E或00247e0a6c2e

C

  

DEVICE_ID

设备号

C(129)

建议PC设备采集硬盘序列号、安卓系统设备采集IMEI、IOS设备采集IDFV

C

  

GPS

GPS位置

C(1,32)

经纬度，格式为维度/经度，+表示北纬、东经，-表示南纬、西经 举例：+37.12/-121.23 或者 +37/-121

C

  

DEVICE_NUMBER

SIM卡号码

C(1,32)

存储11位手机号，存在2个通讯设备号码的话，用逗号分隔

C

  

DEVICE_SIMNUM

SIM卡数量

C(1,8)

设备SIM卡数量

C

  

ACCTIDHASH

账户ID

C(1,64)

商户端用户支付时，如处于用户登录状态，提供商户系统中的用户ID

C

  

RISKSCORE

风险评分

C(1,8)

风险等级评分（0-1000分）

C

  

RISKREASONCODE

风险评分的主要原因码

C(1,100)

风险评分的主要原因码

C

  

MCHNTUSRRGSTRTM

收单端用户注册日期

C(14)

收单端用户注册时间，14位时间字符yyyyMMddHHmmss

C

  

MCHNTUSRRGSTREMAIL

收单端用户注册邮箱地址

C(1,64)

收单端用户注册邮箱地址

C

  

RCVPROVINCE

收货省

C(1,4)

收货地-省 上送银联清算地区代码

C

  

RCVCITY

收货市

C(1,4)

收货地-市 上送银联清算地区代码

C

  

GOODSCLASS

商品类别

C(1)

商品类别：0不确定 1虚拟 2非虚拟

C

  

3.1.4.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310011

M

详见报文头说明

VERSION

版本号

C(2)

06

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B1与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FASTTRXRET

RET_CODE

返回码

C(4)

参考附录B1与B6

C

  

SETTLE_DAY

完成日期

C(8)

YYYYMMDD

C

上送08版本，完成时间返回14位格式：YYYYMMDDhhmmss

ACCT_SUFFIX

卡号后4位

C(4)

  

C

 

ERR_MSG

错误文本

C(1,256)

  

C

 

VOUCHERNO

银行流水号

C(1,46)

  

C

VERSION为06才返回该值

3.1.4.4 例子

无分账需要不需要上传分账节点 <LEDGERS> </LEDGERS>


<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310011</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL></LEVEL>
<MERCHANT_ID>200604000005432</MERCHANT_ID>
<USER_NAME>20060400000543204</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200604000005432-0001677567433708</REQ_SN>
<SIGNED_MSG>9c6ae666e8756d28843aeea7a573ace88adb88c239de3fa22e5cc3968524880baf371b3b0cadd3becce1d4b9c61fe2fbadcc64b35e0e69c8751895498526f339ddb22bd90f23e389f4fd811984f296a3ad5bc939970a510f11865484467c182dfaeb873a4554d2d8bf61da7a19d01d8ecb8265d07f8d37a6faa27883a230ac87</SIGNED_MSG>
</INFO>
<FASTTRX>
<BUSINESS_CODE>19900</BUSINESS_CODE>
<MERCHANT_ID>200604000005432</MERCHANT_ID>
<SUBMIT_TIME>20230228145713</SUBMIT_TIME>
<AGRMNO>AIP1888221213001008469</AGRMNO>
<ACCOUNT_NO>621481*****38224</ACCOUNT_NO>
<ACCOUNT_NAME>林*****雄</ACCOUNT_NAME>
<AMOUNT>4</AMOUNT>
<CUST_USERID>哈哈哈哈</CUST_USERID>
<SUMMARY>asjdfasdfkasdf</SUMMARY>
<REMARK>a发送到发斯蒂芬</REMARK>
<FEEFLAG>0</FEEFLAG>
<NOTIFYURL>https:113.108.19.20/notify</NOTIFYURL>
</FASTTRX>
<LEDGERS>
<LEDGERDTL>
<SN>0</SN>
<MERCHANT_ID>200604000006167</MERCHANT_ID>
<AMOUNT>1</AMOUNT>
<TYPE>0</TYPE>
</LEDGERDTL>
<LEDGERDTL>
<SN>1</SN>
<MERCHANT_ID>200604000006167</MERCHANT_ID>
<AMOUNT>1</AMOUNT>
<TYPE>0</TYPE>
</LEDGERDTL>
</LEDGERS>
</AIPG>
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310011</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200604000005432-0001677567433708</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>请求成功</ERR_MSG>
<SIGNED_MSG>9ae64a2140a5802dad0ccd330aac61ea1cacff14cb6a70a6ba399f6b9b0bf3042dcfea2db49cb61a6d48fec4015e5c573c41c84e0b74030e4b16c21b5c76856002ddb701b8f81788f1ba9fc6088806aa106082eabc2b74fcf754c3a97e5f2eeb7acb01bf44bbb463c77485553b8e0e8519ec4174d74cfbdfef9e7ed46021f26afb209eb9c86aec37a3825fa3ec59254783045ce29747a1c2bdd33b106fdf83fc256697973a5233547724a420b4b6e07ed2f1b0e9337ea8b4c5edce58d9233d8454bf3b1f4a8125769c64758e7a3725da74bfa48442ec184c11eb38e794b32a884cda2cd1f2f9042a1bae7e29f81c9249804ec2aacd94761f3f60c41efbe1872e</SIGNED_MSG>
</INFO>
<FASTTRXRET>
<RET_CODE>0000</RET_CODE>
<SETTLE_DAY>20230228</SETTLE_DAY>
<ERR_MSG>处理成功</ERR_MSG>
<ACCT_SUFFIX>8224</ACCT_SUFFIX>
</FASTTRXRET>
</AIPG>

3.1.5批量协议支付(310016)

3.1.5.1 报文功能

  • 适应于需进行批量协议支付的场景（不能有一个批次只有一笔交易明细情况）。
  • 批量协议支付代收实时返回只是通联受理成功，不代表该交易的已经有最终状态，受理成功只是处理中状态，非实时的，处理时效根据交易笔数限制，要发起交易查询。
  • 建议批量发起的交易笔数不超过2000笔，还有批次中不能存在相同卡号的交易。

3.1.5.2 请求报文

 

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310016

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

请求流水号

C(0,60)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

BODY/

TRANS_SUM

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

  

MERCHANT_ID

商户号

C(15)

  

M

  

SETTDAY

清算日期

C(14)

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

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

商户id

C

AMOUNT

分账金额

C(1,12)

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

M

TYPE

分账类型

C(1)

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

C

BODY/

TRANS_SUM/

DETAIL_LEDGERS/LEDGERDTL

SN

分账序号

C(1,4)

  

C

按批次对的具体明细sn分账，汇总与明细分账只能二选一

MERCHANT_ID

分账商户号

C(10,15)

分账的商户号需要先在后台配置

C

AMOUNT

分账金额

N(1,12)

分账类型为：0 按金额分账时需填写

C

TYPE

分账类型

C(1)

0按金额分账； 1 按比例分账，默认0（如果按比例分是后台固定配置的，分账金额可为空）

C

DETAIL_SN

分账明细对应的sn

C(1,4)

需分账的记录序号

C

BODY/

TRANS_DETAILS/

FASTTRX_DETAIL

SN

记录序号

C(1,4)

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

M

  

AGRMNO

协议号

C(22)

签约时返回的协议号

C

卡号和协议号其中一个必填，优先通过卡号匹配协议号

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

C

 

BANK_CODE

银行代码

C(8)

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

C

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

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

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

卡号和协议号其中一个必填，优先通过卡号匹配协议号

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

CURRENCY

货币类型

C (3)

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

C

 

ID_TYPE

开户证件类型

C (1)

参考A.1证件类型

C

  

ID

证件号

C (1,22)

 

C

  

TEL

手机号/小灵通

C (1,13)

 

C

  

CVV2

CVV2

C (3)

  

C

无需填写

VAILDDATE

有效期

C (4)

  

C

无需填写

AMOUNT

金额

C(1,12)

整数，单位分）

M

  

E_USER_CODE

用户编号

C (1,20)

 

C

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

CUST_USERID

自定义用户号

C (1,128)

 

C

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

SUMMARY

交易附言

C (1,140)

 

C

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

REMARK

备注

C (1,50)

 

C

供商户填入备注信息。

SETTACCT

本交易结算户

C(32)

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

C

  

3.1.5.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310016

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

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.5.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310016</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<LEVEL>5</LEVEL>
<MERCHANT_ID>200801000000021</MERCHANT_ID>
<USER_NAME>20080100000002104</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200801000000021-0001541143618147</REQ_SN>
<SIGNED_MSG>8316630bbd2e4ee33d827934e9c33363eead39ad9b8c0a722eee45fe052797069bdb93086507904750fb961cdc696e13ed426345598851c951bcf64b2055b2d7c505bd43fc690c0ca79fac1ce8c3812d4808408396fdde51453cd53de4a12261b591784fe4b150d677d43a8409167e8ebd736be5d3db25ac7636cd746c6c40c0</SIGNED_MSG>
</INFO>
<BODY>
<TRANS_SUM>
<BUSINESS_CODE>19900</BUSINESS_CODE>
<MERCHANT_ID>200801000000021</MERCHANT_ID>
<SUBMIT_TIME></SUBMIT_TIME>
<TOTAL_ITEM>1</TOTAL_ITEM>
<TOTAL_SUM>1000000</TOTAL_SUM>
<SETTDAY></SETTDAY>
</TRANS_SUM>
<TRANS_DETAILS>
<FASTTRX_DETAIL>
<SN>00002</SN>
<E_USER_CODE></E_USER_CODE>
<BANK_CODE></BANK_CODE>
<ACCOUNT_TYPE></ACCOUNT_TYPE>
<ACCOUNT_NO>6217001*****2565987</ACCOUNT_NO>
<ACCOUNT_NAME>买单宝专用四</ACCOUNT_NAME>
<PROVINCE></PROVINCE>
<CITY></CITY>
<BANK_NAME></BANK_NAME>
<ACCOUNT_PROP></ACCOUNT_PROP>
<AMOUNT>1000000</AMOUNT>
<CURRENCY></CURRENCY>
<PROTOCOL></PROTOCOL>
<PROTOCOL_USERID></PROTOCOL_USERID>
<ID_TYPE></ID_TYPE>
<ID></ID>
<TEL></TEL>
<CUST_USERID>哈哈哈哈</CUST_USERID>
<REMARK>a发送到发斯蒂芬</REMARK>
<SETTACCT></SETTACCT>
<SETTGROUPFLAG></SETTGROUPFLAG>
<SUMMARY>asjdfasdfkasdf</SUMMARY>
<UNION_BANK></UNION_BANK>
<FEEFLAG></FEEFLAG>
<AGRMNO>AIP5987181018000001801</AGRMNO>
</FASTTRX_DETAIL>
</TRANS_DETAILS>
</BODY>
</AIPG>
============================响应报文============================
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>310016</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200801000000021-0001541143618147</REQ_SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG>受理成功</ERR_MSG>
<SIGNED_MSG>25d95bb3df3f695c634ec8ce91c3ca4bf7b020d840f508b224e9330c8163a2c2be99fad5a5079a29a7b1f08b8017c61d13fbae415475f5ca16f7db14802dd565679e70c4dfe0f0a5af2772f90b795f1ea3eb257cf9ca4eeb6741e809db39dee545d486121411cecca961c30f431b3f40dfbab50f0b8236622322efe69be5698a3d307be54ac95432c677be0219f91bda19e7f202ebda686391fc3855249f0889573e24fe8ec0d9abf73fd641c716b7df90b5aae1beaa459beac2c7fde8da1ee3b0f22e03d1d3072fb322d3e67c197f9cff68db3f796a2653f774f9d8efa11ed18f2c1c1998229120bca1566721ea93787d21770fd8ffc3814940c48673b3a9d7</SIGNED_MSG>
</INFO>
<BODY>
<RET_DETAILS>
<RET_DETAIL>
<SN>00002</SN>
<RET_CODE>0000</RET_CODE>
<ERR_MSG></ERR_MSG>
</RET_DETAIL>
</RET_DETAILS>
</BODY>
</AIPG>

3.1.6签约结果查询(340009)

3.1.6.1 报文功能

  • 适用于签约超时或收不到签约结果，按原签约申请流水号（310001）/(310006) 发起签约结果查询,只支持查询近2天的数据。

3.1.6.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

340009

M

详见报文头说明

VERSION

版本号

C(2)

05

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

  

QAGRINFO

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

AGRTYPE

协议类型

C(2)

01：标准快捷协议

M

  

QUERY_MODE

查询模式

C(1)

1:通过签约流水号查询

M

 

QUERY_SN

要查询的交易流水

C(60)

也就是原请求交易中的REQ_SN的值

M

  

3.1.6.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

340009

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B1与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

QAGRRSP/

QAGRDETAIL

MERCHANT_ID

商户代码

C(10,20)

  

C

商户ID

AGRMNO

协议号

C(100)

  

C

 

BANK_CODE

银行代码

C(3,8)

银行代码，见附录A3

C

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

ACCOUNT_NO

账号

C(4)

卡号

C

根据配置是否返回全卡号，默认卡号后4位;

TEL

手机号

C (1,13)

  

C

根据配置是否返回

STATUS

协议状态

C(4)

  

C

0：申请成功待确认 1：处理中 2 签约成功 3签约失败 4签约申请失败

 

ERR_MSG

错误文本

C(256)

  

C

 

3.1.6.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>340009</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE></DATA_TYPE>
<LEVEL>5</LEVEL>
<MERCHANT_ID>200801000000021</MERCHANT_ID>
<USER_NAME>20080100000002104</USER_NAME>
<USER_PASS>111111</USER_PASS>
<REQ_SN>200801000000021-0001541144412708</REQ_SN>
<SIGNED_MSG>51113cfc28e78e9bbb9249ab4d75f98bbf8b8a5ca812f792096b5478d2cf0421aeb4951bd0a8070c6df3c504ce6282bb0edfca48c5a61ac91f684985f000e4c5825a8790922ab606399a4f88285b1a43ec2b87e9a3d5620c2e6bceb472ddb382e9a5c0c3a1627668fbddb12ed19a1bc46ac06af8a70975d3ed5fd04388ca7bff</SIGNED_MSG>
</INFO>
<QAGRINFO>
<MERCHANT_ID>200801000000021</MERCHANT_ID>
<AGRTYPE>01</AGRTYPE>
<QUERY_MODE>3</QUERY_MODE>
<ACCOUNT_NO>******</ACCOUNT_NO>
</QAGRINFO>
</AIPG>
============================响应报文============================
<?xml version="1.0" encoding="GBK"?><AIPG>
<INFO>
<TRX_CODE>340009</TRX_CODE>
<VERSION>05</VERSION>
<DATA_TYPE>2</DATA_TYPE>
<REQ_SN>200801000000021-0001541144412708</REQ_SN>
<RET_CODE>1002</RET_CODE>
<ERR_MSG>查无此记录</ERR_MSG>
<SIGNED_MSG>66d1d7d8c14d5a15bd225c4d396fe06c5811879c95165909a579c15eb4401256eef0b02b7ad542fd60cd85ab286a04bdc77d9c9d9c8ddebd7b57d4e2162d208322416aeab472568534bbcbd87c0f4a906241bf626af6dcfe49b71305e01b842acf46b9a58f9eb7df9e2e7d814e1541c57e04a951a18237b4ffa9cc3f072e91fb48fdb888b3e03fff1d87ffb1d91ae33c61bcfad6b2ef3b02fe28d4fa4273add7dba88b34754863953c4f6ae6d40b18f83574d6c46f2603be481936af78cec7b3780b77f24d4681a5437a40ae725811d35e54d6069f88085855557b7f34c3abfbea9d24b228bf36ed4e49a4e7c6dad0d22613f8c9564fe90d3b377b89443262df</SIGNED_MSG>
</INFO>
</AIPG>

3.1.7协议支付签约合并支付(310010)

3.1.7.1 报文功能

  • 适应于首次签约后并由通联直接完成支付的场景。同时也兼容非首次扣款的场景。
  • 短信验证码有效确认时间为10分钟。
  • 当请求超时需，先通过3.1.6快捷协议查询（340009）进行协议号的查询，再通过3.9.2交易结果查询（200004）查询交易最终结果。查询结果有如下四种情况。
  • 1)签约交易不存在，支付交易不存在：说明交易没上送到通联服务端，商户可重发交易。 2)签约成功，支付成功：340009查询接口返回协议号，200004查询接口返回成功的返回码。 3)签约成功，支付失败：340009查询接口返回协议号，200004查询接口返回失败的返回码。 4)签约失败：340009查询返回1002找不到协议记录。

3.1.7.2 请求报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310010

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

LEVEL

处理级别

N(1)

5

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

请求流水号

C(0,60)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

FASTTRX

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

  

MERCHANT_ID

商户号

C(10,20)

  

M

  

SUBMIT_TIME

提交时间

C(14)

YYYYMMDDHHMMSS

M

  

SRC_REQ_SN

原请求流水

C(40)

对应申请 请求报文中的REQ_SN

M

  

VER_CODE

验证码

C(6)

短信验证码

M

  

AGRMNO

协议号

C(22)

  

C

当该字段有值时，按非首次扣款的流程走。此时SRCREQSN、VERCODE可填空

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

C

BANK_CODE

银行代码

C(8)

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

C

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

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

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

  

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

AMOUNT

金额

C(12)

整数，单位分

M

  

CURRENCY

货币类型

C (3)

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

C

ID_TYPE

开户证件类型

C (1)

参考A.1证件类型

C

  

ID

证件号

C (1,22)

C

  

TEL

手机号/小灵通

C (1,13)

C

  

CVV2

CVV2

C (3)

  

C

  

VAILDDATE

有效期

C (4)

  

C

  

CUST_USERID

自定义用户号

C (1,128)

C

商户自定义的用户号，开发人员可当作备注字段使用

SUMMARY

交易附言

C (30)

C

填入网银的交易备注, 开发人员可省略该字段，也可以当作备注字段使用

REMARK

备注

C (1,50)

C

供商户填入备注信息。

3.1.7.3 响应报文

接口

字段ID

字段解释

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1,20)

310010

M

详见报文头说明

VERSION

版本号

C(2)

05

M

  

DATA_TYPE

数据格式

C(1)

2

M

  

REQ_SN

请求流水号

C(0,60)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B1与B6

M

  

ERR_MSG

错误信息

C(1,256)

  

M

  

SIGNED_MSG

签名信息

C

  

M

  

FASTTRXRETC

AGRMNO

协议号

C(22)

  

C

  

ACCT_SUFFIX

卡号后4位

C(4)

  

C

 

SETTLE_DAY

完成日期

C(8)

YYYYMMDD

C

 

RET_CODE

返回码

C(4)

参考附录B1与B6

C

 

ERR_MSG

错误文本

C(256)

  

C

 
  • RET_CODE非0000,AGRMNO无值，代表签约失败，不再做进一步的支付，返回码代表签约失败的原因。
  • RET_CODE非0000,AGRMNO有值，代表签约成功，支付失败，返回码代表支付失败的原因。
  • RET_CODE等于0000,AGRMNO有值，代表签约成功，支付成功。

3.1.7.4 例子

<?xml version="1.0" encoding="GBK"?><AIPG>
<?xml version="1.0" encoding="GBK"?> <AIPG>
<INFO>
<TRX_CODE>310010 </TRX_CODE>
<VERSION>05 </VERSION>
<DATA_TYPE>2 </DATA_TYPE>
<LEVEL>5 </LEVEL>
<MERCHANT_ID>200801000000021 </MERCHANT_ID>
<USER_NAME>20080100000002104 </USER_NAME>
<USER_PASS>111111 </USER_PASS>
<REQ_SN>200801000000021-0001541144908814 </REQ_SN>
<SIGNED_MSG>835ded71af022bd74d99470d4b91acbb4296272ae5648750b85af3ca6130107ecdf335dceeb7fcbf79b98110b7b4f5f6a56ebd5dc92310a151733278e6eb46862fbf48c42bf37693a31ab9d48f71f632d729de344263705e0f2e8d3dc48c8cadcb55543a402d3ac6116f745405a3b2609cee9426ea42eed7f0319f60310b9cb3 </SIGNED_MSG>
</INFO>
<FASTTRX>
<BUSINESS_CODE>19900 </BUSINESS_CODE>
<MERCHANT_ID>200801000000021 </MERCHANT_ID>
<SUBMIT_TIME>20181102154828 </SUBMIT_TIME>
<AGRMNO>AIP5988180829000002067 </AGRMNO>
<ACCOUNT_NAME>买单宝专用四 </ACCOUNT_NAME>
<AMOUNT>90 </AMOUNT>
<CUST_USERID>哈哈哈哈 </CUST_USERID>
<SUMMARY>asjdfasdfkasdf </SUMMARY>
<REMARK>a发送到发斯蒂芬 </REMARK>
<SRC_REQ_SN>200604000005095-0001536132935606 </SRC_REQ_SN>
<VER_CODE>111111 </VER_CODE>
</FASTTRX>
</AIPG>
============================响应报文============================
<?xml version="1.0" encoding="GBK"?> <AIPG>
<INFO>
<TRX_CODE>310010 </TRX_CODE>
<VERSION>05 </VERSION>
<DATA_TYPE>2 </DATA_TYPE>
<REQ_SN>200801000000021-0001541144908814 </REQ_SN>
<RET_CODE>0000</RET_CODE>https://www.yuque.com/g/tltdoc/api/rlm8z5/collaborator/join?token=lryhAqHJo6DXUzeh&tdsourcetag=s_pctim_aiomsg
<SIGNED_MSG>075d363af708bcc21e7f190145289147ba4c887ca5c3e744cb3427a8c61d66366e7b4837bb13f78e2fe32c16043cf69cd2d922e52f1eed6190934406f1f97e96a29fa664fcf830c08e2f81efce3e7f05a8dd4b9eff963bb8f112f0f6d323571df06787377f5bd0ee0c9e112607cebbaee5687c1f83790276ad321993051b6248ef87a69273acca5fde6e0adc53ea830b27f88c389629b69f39be914d63a75552ae4ebb2baddf56d68bf537275b5a81ba5344969e59e7b4f17356cfdb1ce7eece95287b64263097aab1c250dba11dd6af5f2fdcf9e9bb5e8268aedd9fd3f05a23c65a9037df8481b3c2bf3843c4a97b4329f4a2f8311b4436af8b8245b3ecade0</SIGNED_MSG>
</INFO>
<FASTTRXRETC>
<RET_CODE>3043 </RET_CODE>
<ERR_MSG>协议号未找到或失效 </ERR_MSG>
<AGRMNO>AIP5988180829000002067 </AGRMNO>
</FASTTRXRETC>
</AIPG>

3.1.8 快捷签约协议展示申请（310008）

3.1.8.1 .1 请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310008

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

  

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

交易批次号

C(40)

  

M

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

SIGNED_MSG

签名信息

C

  

M

  

BANKDOCREQ

BANK_CODE

银行代码

C(8)

银行代码，见附录3.3

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

C

银行代码与账号不能同时为空，且优先使用上送的银行代码。

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

银行代码与账号不能同时为空，且优先使用上送的银行代码。

ACCOUNT_TYPE

账号类型

C(2)

00借记卡，02信用卡

M

  

AGRTYPE

协议类型

C(4)

00 商委，01快捷，04

M

  

3.1.8.1 .2 响应报文说明

返回的地址列表会默认包含《通联支付快捷支付服务协议》。

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310008

M

  

VERSION

版本

C(2)

06

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考3.4

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

BANKDOCRSP

BANK_CODE

银行代码

C(8)

银行代码，见附录3.3

M

  

ACCOUNT_TYPE

账号类型

C(2)

00借记卡，02信用卡

C

不区分时为空

BANKDOCRSP/

BANKDOCS/

BANKDOC

NAME

文件名

C(2,32）

  

M

  

URL

URL

C(1,128）

  

M

  

AGRTYPE

协议类型

C(4)

AGRTYPE=04有该字段

C

  

INSTCOD

机构号

C(8)

AGRTYPE=04有 银联值为00010000

C

  

PROTOVN

电子合同号

C(32)

AGRTYPE=04有该字段

C

  

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

1 AGRTYPE的返回值为04，INSTCOD的返回值为00010000，则返回的PROTOVN的值对应于CU_PROTOVN（银联协议版本号）。

2 AGRTYPE的返回值为04，INSTCOD的返回值不为00010000，则返回的PROTOVN的值对应于BNK_PROTOVN（银行协议版本号）。

3 AGRTYPE 不为 04 ，PROTOVN返回值对应的是 快捷协议电子合同号。

3.1.9 授权同步（310030）

3.1.9.1 报文功能

用于544号文改造

3.1.9.2 请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310030

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

  

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

USER_NAME

用户名

C(1,20)

  

M

  

REQ_SN

交易批次号

C(40)

  

M

不重复流水

SIGNED_MSG

签名信息

C

  

M

  

FAGRA

MERCHANT_ID

商户代码

C(15)

商户号ID

M

  

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

  

BANK_CODE

银行代码

C(12)

银行代码，见附录3.3

M

  

ACCOUNT_TYPE

账号类型

C(2)

00借记卡，02信用卡。不填默认为借记卡00。

M

  

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

M

  

ACCOUNT_NAME

账号名

C(1,60)

借记卡或信用卡上的所有人姓名。

M

  

ACCOUNT_PROP

账号属性

C (1)

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

M

  

ID_TYPE

开户证件类型

C (1)

参考3.1

M

  

ID

证件号

C (1,22)

  

M

  

TEL

手机号

C (11)

  

M

  

CVV2

CVV2

C (3)

信用卡时必填

C

  

VALIDDATE

有效期

C (4)

信用卡时必填，格式MMYY(信用卡上的两位月两位年)

C

  

CU_PROTOVN

银联协议版本号

C（32）

  

M

  

BNK_PROTOVN

银行协议版本号

C（32）

  

M

  

MERREM

商户保留信息

C (0,128)

商户保留信息

C

  

REMARK

备注

C (1,50)

供商户填入参考信息

C

  

3.1.9.3 响应报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310030

M

  

VERSION

版本

C(2)

03

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考3.4

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

FAGRCRET

RET_CODE

返回码

C(4)

参考3.4

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

AGRMNO

协议号

C(22)

  

C

  

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

3.1.10 智扣请求（310031）

  • 支持商户上送多个交易扣款金额（看配置轮扣次数，最多N+1个,N为后台配置的最大轮扣次数），针对失败交易按金额大小，系统发起再扣款交易，只会存在一笔扣款交易成功或者全部交易都失败；
  • ·再扣款限制:商户开通该功能时，需配置最大轮扣次数（最大5次，加上主交易，最大扣款6次），档次间隔最小金额>=100元，轮扣最小金额>=100元。系统预检查商户上送的金额是否满足轮扣规则配置要求，不满足则全部交易不发送渠道，包括主交易，并返回对应失败原因。
  • 当只上送了主交易金额，则无需进行轮扣规则校验。

3.1.10.1 请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310031

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

  

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

USER_NAME

用户名

C(1,20)

  

M

  

USER_PASS

用户密码

    

M

  

REQ_SN

交易批次号

C(40)

  

M

不重复流水

SIGNED_MSG

签名信息

C

  

M

  

FASTTRX

MERCHANT_ID

商户代码

C(15)

商户号ID

M

  

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

  

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

  

AGRMNO

协议号

C(22)

签约时返回的协议号

C

卡号和协议号其中一个必填，优先通过卡号匹配协议号

ACCOUNT_TYPE

账号类型

C(2)

00银行卡，02信用卡。不填默认为银行卡00。06:银联token账号

C

  

BANK_CODE

银行代码

C(8)

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

C

存折必填，银行卡视情况填写，详情见2.9.4银行代码说明针对账户类型传06的，必须上送银行代码

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

  

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

AMOUNT

轮扣金额

C(12)

轮扣金额用|分隔，第一个金额为账单金额，后续金额依次减少。单位分

M

  

CURRENCY

货币类型

C(3)

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

C

  

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

C

  

ID

证件号

C(1,22)

  

C

  

TEL

手机号/小灵通

C(1,13)

  

C

  

CVV2

CVV2

C(3)

信用卡时必填

C

  

VALIDDATE

有效期

C(4)

信用卡时必填，格式MMYY(信用卡上的两位月两位年)

C

无需填写

CUST_USERID

自定义用户号

C(1,128)

商户自定义的用户号，开发人员可当作备注字段使用

C

  

REMARK

备注

C(1,50)

供商户填入备注信息。

C

  

SUMMARY

交易附言

C(1,140)

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

C

  

NOTIFYURL

通知地址

C(200)

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

C

  

LEDGERS/

LEDGERDTL

SN

记录序号

C(1,4)

不能重复

C

  

MERCHANT_ID

分账商户号

C(10,20)

  

C

  

TYPE

分账类型

C (1)

1按比例分账

C

  

3.1.10.2 响应报文说明

智扣请求返回的0000表示已受理，不代表最终结果。最终结果请根据通知或者结果查询获取。

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310031

M

  

VERSION

版本

C(2)

03

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考3.4

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

TRANSRET

RET_CODE

返回码

C(4)

参考3.4

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

3.1.11 智扣退款（310033）

智扣退款的金额为原实扣金额。

3.1.11.1请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310033

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

  

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

USER_NAME

用户名

C(1,20)

  

M

  

USER_PASS

用户密码

    

M

  

REQ_SN

交易批次号

C(40)

  

M

不重复流水

SIGNED_MSG

签名信息

C

  

M

  

REFUND

MERCHANT_ID

商户代码

C(15)

  

M

  

ORGBATCHID

原批次

C(0,60)

智扣交易中的REQ_SN的值

M

  

AMOUNT

退款金额

N(1,12)

整数，单位分

M

  

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

  

BUSINESS_CODE

业务代码

C(6)

见附录A2业务代码

M

  

NOTIFYURL

通知地址

C(200)

  

C

  

3.1.11.2 响应报文说明

只有当头部返回码为0000时，才有TRANSRET对象。

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310033

M

  

VERSION

版本

C(2)

03

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考3.4

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

TRANSRET

RET_CODE

返回码

C(4)

参考3.4

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

SETTLE_DAY

清算日期

C(8)

YYYYMMDD

C

  

VOUCHERNO

银行流水号

C(1,46)

  

C

VERSION为06才返回该值

3.1.12 智扣结果查询（310032）

3.1.12.1 请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310032

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

LEVEL

处理级别

N(1)

0-9 0优先级最低，默认为5

M

  

MERCHANT_ID

商户代码

C(15)

商户ID

M

  

USER_NAME

用户名

C(1,20)

  

M

  

USER_PASS

用户密码

    

M

  

REQ_SN

交易批次号

C(40)

  

M

不重复流水

SIGNED_MSG

签名信息

C

  

M

  

QTRANSREQ

QUERY_SN

交易流水号

C(60)

交易流水号

M

  

MERCHANT_ID

商户号

C(15)

  

M

  

3.1.12.2 响应报文说明

只有当头部返回码为0000时，才有SMTDRET对象。当头部返回码为1002时，表示该笔交易不存在。

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310032

M

  

VERSION

版本

C(2)

03

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考3.4

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

SMTDRET

BATCHID

原交易流水

C(60)

原请求交易中的REQ_SN的值

    

TRXCODE

交易类型

C(6)

      

BILLAMT

账单金额

N(1,12)

单位分

  

退款无

TRXAMT

实际发生金额

N(1,12)

单位分

  

原交易为智扣交易时表示实际成功金额；原交易为智扣退款时表示实际退款金额。

CNT

实扣次数

N(1,3)

    

退款无

FEE

手续费

N(1,12)

单位分

    

ACCOUNT_NO

交易账户

C(1,32)

    

脱敏账户

CUST_USERID

商户自定义流水

C (0,128)

原代收付请求报文中的CUST_USERID字段

    

SUMMARY

摘要

C(1,140)

      

FINTIME

交易完成时间

C(14)

      

SETTDAY

结算日期

C(8)

      

RET_CODE

返回码

C(4)

参考3.4

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

3.1.13 智扣交易结果通知

此交易通知由通联向商户指定的url发起，使用HTTP GET|POST方式提交到商户系统，url优先取商户上送，其次取系统配置

3.1.13.1 请求报文说明

URL参数名

说明

类型

取值

可空

备注

RETCODE

返回码

C(4)

  

非空

  

RETMSG

错误信息

C(256)

  

可空

  

ACCOUNT_NO

账号

N(1,32)

银行卡或存折号码

非空

  

AMOUNT

订单金额

N(1,12)

整数，单位分

非空

  

SUCCAMOUNT

实扣金额

N(1,12)

整数，单位分

非空

  

ACTUALCOUNT

实扣笔数

N(1,12)

整数

非空

  

SETTDAY

清算日期

C(8)

yyyyMMdd

非空

  

FINTIME

完成时间

C(14)

yyyyMMddHHmmss

非空

  

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

非空

  

BATCHID

交易批次号

C(40)

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

必填

  

POUNDAGE

手续费

N(12)

整数，单位分

可空

  

USERCODE

用户代码

C(20)

商户客户ID

必填

  

MERID

商户号

C(15)

商户号

必填

  

TRXCODE

交易类型

C(6)

智扣申请：310031，智扣退款申请：310033

必填

  

REMARK

备注

C(1,50)

  

可空

  

SIGN

签名

  

使用SHA1withRSA签名。签名原始内容为 账号|订单金额|实扣金额|实扣笔数|交易批次号|返回码|手续费

必填

  

3.1.13.2 响应报文说明

商户系统返回一行内容

SUCCESS或者ERROR

huangwg 2025年4月24日 17:06 3333 0 条评论 收藏文档