收付通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）” 或 “H5 链接签约（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 分钟；超时后需先通过 “签约结果查询（340009）” 查协议号，再通过 “交易结果查询（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接口功能

  • 申请协议展示链接，返回包含《通联支付快捷支付服务协议》在内的地址列表。
  • 支持通过 “银行代码” 或 “账号” 定位协议类型（如快捷、银联 token 协议）。

3.1.8.2请求报文说明

接口

字段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 

银联token协议

M

  

3.1.8.3响应报文说明

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

接口

字段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 H5链接签约

3.1.10.1 接口功能

  • 生成 H5 签约页面链接，引导持卡人在 H5 页面完成签约操作。
  • 支持配置签约后回跳地址（backurl）和结果通知地址（notifyurl），签约结果通过通知接口推送。

3.8.1.2  请求报文

URL参数名

 

说明

类型

取值

可空

备注

cusid

 

商户号

C(16)

 

非空

 

filename

 

请求流水号

 C(1。60)

 

非空

 

backurl

 

回跳地址

N(1,32)

传值需要URLEncode，格式报文参考

3.10.2  签约回跳接口

可空

 

notifyurl

 

签约结果通知地址

C (1,13)

传值需要URLEncode，签约通知格式报文参考

3.10.3  签约结果通知(310006)

非空

 

signalg

 

签名方式

C(1)

1 国密 0 RSA

非空

 

signstr

 

签名值

 

签名内容 filename + "|" + notifyurl + "|" + backurl;

非空

 

 例子

https://sft-test.allinpay.com/gwsign/web/index.dsr?cusid=200604000005432&filename=WEB2006040000015913&notifyurl=https%3A%2F%2Ftlt-test.allinpay.com%2Faipg%2Fnotifytest%3Fabc%3Dwer%26qwe%3Dasdf&backurl=https%3A%2F%2Fsft-test.allinpay.com%2Fgwsign%2Fweb%2Ftips.dsr%3Fabc%3Dwde&signalg=0&signstr=4fe01a884a142112fcb7956e2ce21848ea8581927983e42c8880ce237408dec6cd28228cd5c735fd16e7028634c798fa2a380d1ca68e661242105c0bb328f785871f5002ac54e6ccca65b5895a5a2d110679e630bc6b43686895d172393f9ea74fa597c93043367c108a204cc6bcf7594035f87b0793e4866e6833bd4d284499

生产的地址换成生产的域名 https://sft.allinpay.com

huangwg 2025年10月24日 17:16 10149 0 条评论 收藏文档