4.3.1签约


生产地址:https://vsp.allinpay.com/apiweb/unconscspay/untokenapply

测试地址:https://syb-test.allinpay.com/apiweb/unconscspay/untokenapply

使用场景:

商户调用此接口发起银联签约支付产品的签约,签约成功通知协议号(不通知持卡人敏感信息,例如卡号手机号码等),如果通知接收失败,请重新发起签约。

 

请求参数:

参数

参数名称

取值

可空

最大长度

备注

cusid

商户号

平台分配的商户号

15

 

appid

应用ID

平台分配的APPID

8

 

version

版本号

接口版本号

2

默认填12

meruserid

会员编号

签约持卡人在商户所属会员编号

32

 

meruserregitdate

会员注册日期

 

32

 

meruserloginmet

会员登录方式

录密码|动码|人脸 |FACEID|指纹(涉及为1,否则为0  如11111)

5

 

applyid

申请id

商户申请协议的流水

32

 

encrypttype

敏感字段

签名类型

暂支持SM4

4

SM4

acctno

银行卡号

SM4加密

可空

20

可空

如果为空用户

在银联页面

选择签约的卡号

idno

证件号

SM4加密

22

 

idtype

证件类型

0:身份证

1:户口簿

2:护照

3:军官证

4:士兵证

5:港澳通行证

6:台湾通行证

7:临时身份证

8:外国人居留证

9:警官证

X:其他证件

1

 

acctname

户名

Sm4加密

20

 

mobile

手机号码

Sm4加密

11

 

bankcode

银行编码

可空,

如果为空,

银联签约页面

会展示所有银行的银行卡

16

 

accttype

卡类型

 

4

00借记卡

02贷记卡

chnltrid

渠道标记id

银联分配

32

 

tokentype

Token类型

银联分配

8

 

deviceid

设备id

 

32

 

facetype

人脸验证方式

 

1

1 商户自验

2 银联或第三方

faceorder

人脸订单号

 

1

facetype为2上送

faceapp

人脸云服务ID

 

1

facetype为2上送

invoketype

拉起方式

 

2

小程序上送

( 03 小程序  

04 公众号)

wxappid

小程序id

 

16

小程序上送

notify_url

签约完成通知地址

url不能含参数

签约完成后将签约信息通知该地址

详见签约结果通知接口

256

 

returl

前端跳转地址

url不能含参数

 

256

 

randomstr

随机字符串

商户自行生成的随机字符串

32

 

signtype

签名方式

 

8

RSA

SM2

sign

签名

详见安全规范

32

 

 

 

响应参数:

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

 

8

此字段是通信标识,

非交易结果,

交易是否成功需要查看trxstatus来判断

retmsg

返回码说明

 

100

 

以下信息只有当retcode为SUCCESS时有返回

cusid

商户号

平台分配的商户号

15

 

appid

应用ID

平台分配的APPID

8

 

applyid

申请id

原样返回

32

 

signinfo

协议签约信息

用于商户小程序/H5或者app

调起云闪付的签约平台

-

 

randomstr

随机字符串

随机生成的字符串

32

 

sign

签名

 

32

详见安全规范 


yinjr 2025年4月24日 10:55 收藏文档