中国银联开放平台

文档中心

接口列表

代收

代收类交易

消费撤销接口

退货类接口

交易状态查询交易

签约

存量签约

解除签约

银联加密公钥更新查询接口

发送短信验证码

批量类交易接口

批量交易状态查询类交易接口

文件传输接口

代收

查看产品

更新时间：2022-08-09

签约

接口描述

签约主要适用于代收业务中的代收业务委托建立，自助消费、自助转账业务中实名终端的账户定制；签约交易包含有卡方式签约和无卡方式签约，其中有卡签约一般由线下专用POS机具发起的有磁有密交易，需卡片出现和交易密码验证，验证强度高；无卡签约包含了前台签约和后台签约两种模式，双因素验证一般适用于前台签约模式，静态信息验证一般适用于后台签约模式。

请求方式

POST

生产调用地址

https://gateway.95516.com/gateway/api/frontTransReq.do

测试调用地址

https://gateway.test.95516.com/gateway/api/frontTransReq.do

请求参数

中文名称

英文名称

域类型

默认值

请求要求

备注

版本号

version

NS5

无

M-必填

编码方式

encoding

ANS1..20

UTF-8

M-必填

默认取值：UTF-8

产品类型

bizType

无

M-必填

代收款项

billType

ANS2

无

M-必填

代收款项	说明
01	移动电话
02	固定电话
03	水费
04	电费
05	煤气费
06	社保
07	小灵通
08	信用卡还款
09	烟草
10	信用卡中心
11	有线和付费电视
12	保险
13	税务
14	证券公司
15	金融机构
16	贷款还款
17	网络服务费
18	资金归集
19	教育费
20	物业管理费
21	公益捐款
CS	财税库银
RZ	商户实时入账
OT	其他

订单发送时间

txnTime

YYYYMMDDhhmmss

无

M-必填

交易类型

txnType

无

M-必填

取值:72

交易子类

txnSubType

无

M-必填

16：签约

接入类型

accessType

无

M-必填

0：商户直连接入

1：收单机构接入

2：平台商户接入

签名

signature

ANS1..1024

M-必填

填写对报文摘要的签名

签名方法

signMethod

无

M-必填

非对称签名： 01（表示采用 RSA 签名） HASH 表示散列算法 11：支持散列方式验证 SHA-256 12：支持散列方式验证 SM3

渠道类型

channelType

无

M-必填

商户代码

merId

AN15

无

M-必填

商户订单号

orderId

AN8..40

无

M-必填

商户订单号，不能含“-”或“_”;

商户自定义，同一交易日期内不可重复;

商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。

银行卡验证信息及身份信息

customerInfo

ANS1..1024

无

M-必填

查看详情

账单号码

billNo

ANS1..64

无

M-必填

表示用户号码，仅支持数字和字母，最长40位

账号

accNo

AN1..1024

无

M-必填

证书ID

certId

N1..128

无

M-必填

二级商户代码

subMerId

AN5..15

无

C-按条件必填

商户类型为平台类商户接入时必须上送

二级商户简称

subMerAbbr

ANS1…16

无

C-按条件必填

商户类型为平台类商户接入时必须上送

二级商户名称

subMerName

ANS1..40

无

C-按条件必填

商户类型为平台类商户接入时必须上送

后台通知地址

backUrl

ANS1..256

无

C-按条件必填

后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，不支持换行符等不可见字符，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX|

如果不需要发后台通知，可以固定上送http://www.specialUrl.com

加密证书ID

encryptCertId

N1..128

无

C-按条件必填

商户简称

merAbbr

ANS1..8

无

C-按条件必填

接入类型为收单机构接入时需上送

商户类别

merCatCode

无

C-按条件必填

填写 MCC 码，接入类型为收单机构接入时需上送

商户名称

merName

ANS1..40

无

C-按条件必填

接入类型为收单机构接入时需上送

商户英文名称

merEnName

ANS40

C-按条件必填

查看详情

收单机构代码

acqInsCode

AN8..11

无

C-按条件必填

接入类型为收单机构接入时需上送

有卡交易信息域

cardTransData

ANS1Trans

无

C-按条件必填

查看详情

终端号

termId

ANS8

无

C-按条件必填

channelType = 03 时， termId 必填

保留域

reserved

ANS1..2048

无

O-选填

查看详情

持卡人IP

customerIp

NS7..40

无

O-选填

有 IP 防钓鱼要求的商户上送

风控信息域

riskRateInfo

ANS 1..2048

无

O-选填

查看详情

控制规则

ctrlRule

N32

无

O-选填

32位01字符串控制位，

第五位取值为1时表示不返signPubKeyCert字段

前台通知地址

frontUrl

ANS1..256

无

O-选填

前台交易需填写

请求方保留域

reqReserved

ANS1..1024

无

O-选填

商户自定义保留域，交易应答时会原样返回

应答报文（同步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
签名	signature	ANS1..1024	0	M-必填
签名方法	signMethod	N2	无	M-必填
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
签名公钥证书	signPubKeyCert	AN1..2048	无	C-按条件必填	此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
收单机构代码	acqInsCode	AN8..11	无	C-按条件必填	接入类型为收单机构接入时需返回
账号	accNo	AN1..1024	无	C-按条件必填	根据商户配置返回
支付卡类型	payCardType	N2	无	C-按条件必填	根据商户配置返回
版本号	version	NS5	无	R-需要返回
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
产品类型	bizType	N6	无	R-需要返回
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回
交易类型	txnType	N2	无	R-需要返回	取值:72
交易子类	txnSubType	N2	无	R-需要返回
接入类型	accessType	N1	无	R-需要返回	0：商户直连接入 1：收单机构接入 2：平台商户接入
请求方保留域	reqReserved	ANS1..1024	无	R-需要返回
商户代码	merId	AN15	无	R-需要返回
商户订单号	orderId	AN8..40	无	R-需要返回	商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
保留域	reserved	ANS1..2048	无	O-选填	查看详情
发卡机构代码	issInsCode	AN1..11	无	O-选填

异常应答说明

1. 不返回报文体的情况：

版本号，交易类型、子类，签名方法，签名值等关键域未上送，返回“Invalid request.”；交易类型和请求地址校验有误，返回“Invalid request URI.”

2. 返回全部的请求报文，附加应答码和应答描述（包括的应答码有：01、02、03、10、11、32）：

验证签名失败；

报文格式错（包含，必填域缺失，上送银联报文未定义的域，报文域的格式非法，交易时间超出范围）；

签名失败；

超时等其他系统异常

提示信息

提示