收付通API

通联核心产品文档中心

3.11一键多绑接口组

目录

3.11.1一键多绑申请（310045）

3.11.1.1接口功能

商户可通过该接口发起一键多绑的申请操作，向通联支付系统提交相关的商户信息、用户身份信息（账号名、证件类型及号码、手机号等）以及申请时间等关键数据。

系统接收申请请求后，会对提交的字段进行合法性校验，如检查必填字段是否完整、字段格式是否符合要求等。

校验完成后，通过响应报文向商户返回申请处理的结果，包括返回代码和对应的错误信息（若有错误），方便商户了解申请是否被系统正常接收和初步处理。

3.11.1.2请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310045

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

  

MULTBIND

MERCHANT_ID

商户代码

C(15)

商户号ID

M

  

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

  

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

M

  

ID

证件号

C(1,22)

  

M

  

TEL

手机号/小灵通

C(1,13)

  

M

  

MERREM

自定义用户号

C(1,128)

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

C

  

REMARK

备注

C(1,50)

供商户填入备注信息。

C

  

3.11.1.3响应报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310045

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B6

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

MULTBINDRSP

RET_CODE

返回码

C(4)

参考附录B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

3.11.2一键多绑确认（310046）

3.11.2.1接口功能

商户在发起一键多绑申请后，可通过该接口提交确认请求，需提供之前申请时的原流水号以及用于验证的验证码，以完成一键多绑的确认步骤。

系统会验证原流水号的有效性，确认该申请记录存在且处于待确认状态，同时校验验证码是否正确。

确认通过后，系统会返回脱敏处理的已绑定账号列表以及对应的银行代码列表，方便商户知晓绑定结果；若验证失败，则返回相应的错误代码和错误信息，提示商户失败原因。

3.11.2.2请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310046

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

  

MULTBINDCFM

MERCHANT_ID

商户代码

C(15)

  

M

  

SRCREQSN

原流水号

C(0,60)

  

M

  

VERCODE

验证码

C(6)

  

M

  

3.11.2.2响应报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310046

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B6

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

MULTBINDRSP

RET_CODE

返回码

C(4)

参考附录B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

ACCOUNT_NO

账号列表

C(360)

  

C

用逗号分隔，脱敏

BANK_CODE

银行代码列表

C(90)

  

C

用逗号分隔，与账号对应

3.11.3一键多绑账户授权申请（310047）

3.11.3.1接口功能

商户可通过该接口为特定的一键多绑业务发起账户授权申请，需指定原一键多绑相关操作的流水号以及需要授权的账号列表（多个账号用逗号分隔）。

系统接收申请后，会对原流水号对应的业务记录进行查询，确认其合法性和关联性，同时校验授权账号列表的格式是否正确。

完成校验和初步处理后，向商户返回授权申请的处理结果，告知商户申请是否被系统受理，若受理失败则说明具体原因。

3.11.3.2请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310047

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

  

MULTBINDCFM

MERCHANT_ID

商户代码

C(15)

  

M

  

SRCREQSN

原流水号

C(0,60)

  

M

  

ACCOUNT_NO

授权账号列表

C(6)

  

M

逗号分隔

3.11.3.2响应报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310047

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B6

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

MULTBINDRSP

RET_CODE

返回码

C(4)

 

参考附录B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

3.11.4一键多绑账户授权确认（310048）

3.11.4.1接口功能

商户在发起账户授权申请后，通过该接口提交确认请求，需提供原授权申请的流水号和验证码，以完成账户授权的确认操作

系统会验证原流水号对应的授权申请记录是否存在且处于待确认状态，同时校验验证码的正确性，确保授权确认操作的安全性和合法性。

确认通过后，系统会返回明文的已授权账号列表以及与各账号对应的协议列表，便于商户进行后续业务处理；若确认失败，则返回错误代码和错误信息，提示商户问题所在。

3.11.4.1请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310048

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

  

MULTBINDCFM

MERCHANT_ID

商户代码

C(15)

  

M

  

SRCREQSN

原流水号

C(0,60)

  

M

  

VERCODE

验证码

C(6)

  

M

  

3.11.4.2响应报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310048

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

 

参考附录B6

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

MULTBINDRSP

RET_CODE

返回码

C(4)

 

参考附录B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

ACCOUNT_NO

账号列表

C(360)

  

C

用逗号分隔，明文

AGRMNO

协议列表

C(90)

  

C

用逗号分隔，与账号对应

3.11.5一键多绑H5（310041）

3.11.5.1接口功能

引导持卡人跳转至通联的H5页面实现一键多绑。

3.11.5.2请求报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310041

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

  

MULTBIND

MERCHANT_ID

商户代码

C(15)

商户号ID

M

  

SUBMIT_TIME

申请时间

C (14)

YYYYMMDDHHMMSS

M

  

ACCOUNT_NAME

账号名

C(1,60)

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

M

  

ID_TYPE

开户证件类型

C(1)

参考A.1证件类型

M

  

ID

证件号

C(1,22)

  

M

  

TEL

手机号/小灵通

C(1,13)

  

M

  

MERREM

自定义用户号

C(1,128)

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

C

  

REMARK

备注

C(1,50)

供商户填入备注信息。

C

  

BACKURL

回跳地址

C(200)

 

C

  

NOTIFYURL

通知地址

C(200)

H5签约结果通知地址

M

  

3.11.5.3响应报文

接口

字段ID

字段名称

类型

取值

限制

备注

INFO

TRX_CODE

交易代码

C(1, 20)

310041

M

  

VERSION

版本

C(2)

04

M

  

DATA_TYPE

数据格式

N(1)

2：xml格式

M

  

REQ_SN

交易批次号

C(40)

  

M

  

RET_CODE

返回代码

C(4)

参考附录B6

M

  

ERR_MSG

错误信息

C(1,256)

  

C

  

SIGNED_MSG

签名信息

C

  

M

  

MULTBINDRSP

 

RET_CODE

返回码

C(4)

参考附录B6

C

  

ERR_MSG

错误文本

C(1,256)

  

C

  

URL

请求url

C(200)

  

 

  


3.11.6签约结果通知

3.11.6.1接口功能

  • 由通联主动向商户指定的通知地址（NOTIFYURL）发起请求，传递签约结果相关信息，包括交易类型、返回码、申请流水号、协议号等，让商户及时获取签约的最终结果。
  • 支持根据配置决定是否返回全卡号，默认情况下仅返回卡号后 4 位，若商户有特殊需求，可申请配置返回全卡号，同时手机号也需申请配置才会在通知中返回。
  • 通知中的签名采用 SHA1withRSA 算法，签名原始内容为返回码 | 协议号 | 账号 | 申请流水号 | 提交时间，商户可通过验证签名确保通知信息的真实性和完整性，防止信息被篡改。

接口详情参考一键绑卡签约结果通知，对应ACCOUNT_NO和AGRMNO分别是授权的账号列表，用逗号分隔。

ACCOUNT_NO=6210801237859439,6216607985612314529& AGRMNO=AIP9439250616989555455,AIP452924101598A0805E0

linwx 2025年10月21日 15:25 694 0 条评论 收藏文档