收付通API

通联核心产品文档中心

3.10一键绑卡/网关签约报文组

目录

3.10一键绑卡/网关签约报文组

1 一键绑卡模式（免卡号）支持以下11个银行：农行、中行、邮储、建行、交行、华夏、广发、平安、浦发、民生，网商（如后续有新增支持银行会更新）

2 网关模式（需要填写4要素），仅支持招行借记卡

3 快捷签约招行网关测试环境网关页面是通联自己模拟。

4 如需兼容到微信小程序上，商户自己要去小程序配置兼容跳转链接的白名单，且用H5链接的方式，需要将客户的小程序校验文件文件加到签约H5的根目录下，测试环境把文件发送给xiegm@allinpay.com,生产的联系事业部提需求。

序号

银行

借记卡

信用卡

1

农业银行

已支持

已支持

2

中国银行

已支持

3

邮储银行

已支持

已支持

4

建设银行

已支持

已支持

5

交通银行

已支持

6

华夏银行

已支持

7

广发银行

已支持

已支持

8

平安银行

已支持

已支持

9

招商银行（网关形式）

已支持

10

浦发银行

已支持

已支持

11

民生银行

已支持

12

网商银行

已支持

 

3.10.1 一键绑卡/网关签约申请(310006)

返回的URL生产的域名会存在两个 ，sft.allinpay.com 、tlt.allinpay.com，如需开通白名单的，两个域名都要加上；

3.10.1.1  请求报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310006

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

用户密码

 

 

C

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

REQ_SN

交易批次号

C(40)

 

M

不重复流水

SIGNED_MSG

签名信息

C

 

M

 

PROTOCOLREQ

MERCHANT_ID

商户代码

C(15)

商户号ID

M

 

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

 

SIGN_MODE

签约模式

C(1)

1一键绑卡

2商委网关

3快捷网关

M

目前签约模式2和3仅招行支持

BUSINESS_CODE

业务代码

C(6)

 

C

当签约模式选择2商委网关时必填

ACCOUNT_TYPE

账号类型

C(2)

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

06:银联token账号

M

 

BANK_CODE

银行代码

C(8)

银行代码，参见附录A.3银行代码

M

 

 

ACCOUNT_NAME

账号名

C(1,60)

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

M

 

ACCOUNT_NO

账号

C(1,32)

银行卡号

C

当签约模式选择2商委网关和3快捷网关时必填

TEL

手机号

C (1,13)

 手机号

C

当签约模式选择2商委网关和3快捷网关时必填

ACCOUNT_PROP

账号属性

C (1)

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

M

 

ID_TYPE

开户证件类型

C (1)

参考3.1

M

 

ID

证件号

C (1,22)

 

M

 

MERREM

商户保留信息

C (0,128)

商户保留信息

C

 

REMARK

备注

C (1,50)

供商户填入参考信息

C

 

 NOTIFYURL

通知地址

C (0,256)

 

C

签约结果通知

BACKURL

跳转地址

C (0,256)

 

M

触发签约回跳接口

3.10.1.2  响应报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310006

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

 

PROTOCOLRSP

RET_CODE

返回码

C(4)

0000

C

不是0000，重发请求

 

ERR_MSG

错误文本

C(1,256)

 

C

 

 

SIGN_MODE

签约模式

C(1)

 

 

 

 

URL

请求url

C(1,256)

 

C

 

 

DATA

请求数据

C(1,2056)

base64编码

C

 

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

3.10.1.3 例子

============================请求报文============================
<?xml version="1.0" encoding="GBK"?><AIPG>
  <INFO>
    <TRX_CODE>310006</TRX_CODE>
    <VERSION>03</VERSION>
    <DATA_TYPE>2</DATA_TYPE>
    <LEVEL>5</LEVEL>
    <MERCHANT_ID>200604000005432</MERCHANT_ID>
    <USER_NAME>20060400000543204</USER_NAME>
    <USER_PASS>111111</USER_PASS>
    <REQ_SN>200604000005432-0001642494335361</REQ_SN>
    <SIGNED_MSG>20def7db03da21f7c0746760726a4ceb26b35983c711b1712c9a6101361ff206a7a7ecc21007180f01d23490031a61e2703367f0d3a98db1ad3a1d3152aad7281ceada5f3a3899336cbf17126b9a18da47371540e715fa38b4a6261875bdf9026a38962181b56d099003c2bdb5279c0a38487ad3c01cd1879a171ff9edaf1a93</SIGNED_MSG>
  </INFO>
  <PROTOCOLREQ>
    <MERCHANT_ID>200604000005432</MERCHANT_ID>
    <SUBMIT_TIME>20220118162535</SUBMIT_TIME>
    <SIGN_MODE>1</SIGN_MODE>
    <BANK_CODE>0308</BANK_CODE>
    <ACCOUNT_TYPE>00</ACCOUNT_TYPE>
    <ACCOUNT_NAME>林</ACCOUNT_NAME>
    <ID_TYPE>0</ID_TYPE>
    <ID>*****************</ID>
    <BACKURL>https://172.16.1.11:8443/aipg/ProcessServlet</BACKURL>
  </PROTOCOLREQ>
</AIPG>
{null=[HTTP/1.1 200 OK], Date=[Tue, 18 Jan 2022 08:25:38 GMT], Content-Length=[1118], Keep-Alive=[timeout=30, max=100], Connection=[Keep-Alive], Content-Type=[text/xml;charset=GBK], Server=[Apache-Coyote/1.1]}
============================响应报文============================
<?xml version="1.0" encoding="GBK"?><AIPG>
  <INFO>
    <TRX_CODE>310006</TRX_CODE>
    <VERSION>03</VERSION>
    <DATA_TYPE>2</DATA_TYPE>
    <REQ_SN>200604000005432-0001642494335361</REQ_SN>
    <RET_CODE>0000</RET_CODE>
    <ERR_MSG>提交成功</ERR_MSG>
    <SIGNED_MSG>42b79f3983d601076436a6137c678812e2eb02860e11e5dbf990d0b15d8b8d652caa24c168abd9e99a447428bc04a628953428ad6e015c9619deff259ce122c009010ed68a1ab7b514ed5d68b4eb36c61525ada1cb238f15efab88e75c57ec0c6173bea73fa8d5f1ac5d66247ebf4b235451ad46e765aa00e518dfdcb2fec8418f3db579b2356443c7b640eec8f242b2e92c93bfec0adb386f9d9ba545ede11fd51d2b19bb4bbab22c9773d7d690a1cdefc85559f0c24708c0294050451d7fc8eac39a1440256a41f824ecdaf189cf9276e5fc70e7fc1b93efe02bc49eee0dba1c32a26168f1d7c04dc27bcf89af5160a97ed6365839ce9263dc746cecfb832a</SIGNED_MSG>
  </INFO>
  <PROTOCOLRSP>
    <RET_CODE>0000</RET_CODE>
    <ERR_MSG>受理成功</ERR_MSG>
    <SIGN_MODE>1</SIGN_MODE>
    <URL>https://test.allinpaygd.com/aiap/sign/bkopen.dsr?sk=tUxj0bVFvTeF0edSCzAr3J5LzABF5plKIpy98uzsHuGIJ2Mf8zasMFHIwjjYGKx%2B%2Fpoe38pzdpJAeoehuxo883KtWRJ0kb%2Fomz2II0ty148%3D</URL>
  </PROTOCOLRSP>
</AIPG>

3.10.2  签约回跳接口

通联签约请求流程结束后，回跳到h5签约申请时商户上送的的回跳地址，默认使用HTTP POST方式，如需要GET方式在310006的回跳地址BACKURL的值加上GET:跳转商户接口地址；（比如BACKURL的值为GET:https://tltdoc.yuque.com/tltdoc/api/sw9dir/edit）如果在BACKURL前面加上GNP:，通过get方式不携带通联参数跳转

3.10.2.1 请求报文说明

URL参数名

说明

类型

取值

限制

备注

RETCODE

返回码

C(4)

 

M

当返回码为“2000”时，表示该签约结果未明确，接入方需要设置超时时间然后等待系统通知。

一键绑卡签约回调返回码都是“2000”。

RETMSG

错误信息

 

 

C

 

REQ_SN

申请流水号

C(40)

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

M

 

AGRMNO

协议号

C(1,100)

协议号

C

成功时有值

ACCOUNT_NO

账号

N(1,32)

账号

M

 

FINTIME

完成时间

C(14)

yyyyMMddHHmmss

M

 

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

M

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为返回码|协议号|账号|申请流水号|提交时间

M

 

 

 

 

 

 

 

3.10.2.2 例子

RETCODE=2000&RETMSG=%E5%B7%B2%E5%8F%91%E9%80%81%E9%93%B6%E8%A1%8C&REQ_SN=200604000005432-0001642491041190&AGRMNO=&ACCOUNT_NO=**&FINTIME=&SUBMITTIME=20220118153044&SIGN=4aa9683c944bd79c8d31ba4608a555048559e3cfa3631c7278cc7668b0259325962ab7b6c98216444b228881773901e380c6ab8a4a94d36549d81ce0997a12552d43d4b7f7f06bab1b1e7efdabeb9c4b57bc4d2d870be06550b8cc4c3fbc4b161f0c5d3d756f1e1e4151b1a202757aa8fb988ebdb28b2868432bbddc40de571a26500ab665a04b1b5b955457ee7070fb2ffb9ab78d3a53604d3382334fe9dcbaa2461b52efff64b230d6f577db21aff63ab30493484c8d8ab9e4125055c2518b98403da26ddc95689748bc47b9c40cc2c285f68ab53a6b0c90978d40251bc9cd78c5f0bb9e7d53b2f5566038dc98dfbaf13ac2183f21091c4fd5f007d1ed0264

3.10.3  签约结果通知(310006)

此交易由通联向商户指定的url发起，使用HTTP GET方式提交到商户系统

3.10.3.1 请求报文说明

URL参数名

说明

类型

取值

限制

备注

TRXCODE

交易类型

C(6)

310006

M

 

RETCODE

返回码

C(4)

 

M

 

RETMSG

错误信息

 

 

C

 

REQ_SN

申请流水号

C(40)

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

M

 

AGRMNO

协议号

C(1,100)

协议号

C

成功时有值

ACCOUNT_NO

账号

N(1,32)

账号

C

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

FINTIME

完成时间

C(14)

yyyyMMddHHmmss

M

 

TEL

手机号

C(13)

 

C

需要申请配置才返回

SUBMITTIME

提交时间

C(14)

yyyyMMddHHmmss

M

 

SIGN

签名

 

使用SHA1withRSA签名。签名原始内容为返回码|协议号|账号|申请流水号|提交时间

M

 

3.10.3.2 响应报文说明

商户系统返回一行内容

SUCCESS或者ERROR

3.10.3.3 例子

http://baidu?ACCOUNT_NO=****&RETCODE=0000&RETMSG=交易成功&REQ_SN=200604000005432-0001642487547440&TRXCODE=310004&AGRMNO=AIP4545220118001006311&FINTIME=20220118143344&SUBMITTIME=20220118143230&SIGN=5cfe8b32c95840234653a35565b87083614188b9e2117b7be5f8e311327d636a0e4c99e99c69cc316cddac48ff9d6d4e4b750ac74c6c4654353995e42c33dbbe94d4d20922566fc869ae20c7a13827636a7069a90caa3b1c70a9886af17a817fcdb73b948f22a345858112f1ebb703e85715695f76d55d7cd1a8e33a784b35cfaea1999c90c14b12880d53bf978ab10b1aba086e8648694c04c09642d2a251c2b6cf36f0b756b0225a06c13a9424d5ffe0d74693eb7145d37ee34d7c9f6a56421d1683ec9427fd6b0ec2a904bb5ad31b4ff3378627e0

3.10.4 短信签约(310009)

补充 ：是网关签约的扩充（针对商户系统不能打开外部链接的，发送短信给此卡人，持卡人根据短信链接进入签约页面）；

 3.10..4.1请求报文说明

 

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310009

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

用户密码

 

 

C

 

REQ_SN

交易批次号

C(40)

 

M

不重复流水

SIGNED_MSG

签名信息

C

 

M

 

PROTOCOLREQ

MERCHANT_ID

商户代码

C(15)

商户号ID

M

 

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

 

SIGN_MODE

签约模式

C(1)

0快捷签约

1一键绑卡

2-商委网关

3-快捷网关

M

 

BUSINESS_CODE

业务代码

C(6)

 

C

 

ACCOUNT_TYPE

账号类型

C(2)

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

M

 

BANK_CODE

银行代码

C(12)

银行代码，见附录3.3

M

 

ACCOUNT_NAME

账号名

C(1,60)

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

M

 

ID_TYPE

开户证件类型

C (1)

参考3.1

M

 

ID

证件号

C (1,22)

 

M

 

TEL

手机号

C (11)

 

M

 

ACCOUNT_PROP

账号属性

C (1)

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

M

 

ACCOUNT_NO

账号

N(1,32)

借记卡或信用卡

C

 

MERREM

商户保留信息

C (0,128)

商户保留信息

C

 

REMARK

备注

C (1,50)

供商户填入参考信息

C

 

BACKURL

跳转地址

C (0,256)

 

M

 

NOTIFYURL

 

通知地址

C (0,256)

 

C

 

3.10.4.2 响应报文说明

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310009

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

 

PROTOCOLRSP

RET_CODE

返回码

C(4)

参考3.4

C

 

ERR_MSG

错误文本

C(1,256)

 

C

 

SIGN_MODE

签约模式

C(1)

 

 

 

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

 

huangwg 2025年4月24日 14:20 854 0 条评论 收藏文档