4.1.2签约申请


生产接口地址:https://vsp.allinpay.com/apiweb/qpay/agreeapply
测试接口地址:https://syb-test.allinpay.com/apiweb/qpay/agreeapply

使用场景:绑卡获取签约短信

trxstatus 返回处理说明:

1999: 短信验证码已发送,请调用申请确认完成签约

3999: 签约失败

请求参数:

参数 参数名称 取值 可空 最大长度 备注
cusid 商户号 通联分配的商户号 15  
appid 应用ID 平台分配的APPID 8  
version 版本号 接口版本号 2 默认填11
reqip 请求ip   32  
reqtime 本次请求时间   16 yyyyMMddHHmmss
randomstr 随机字符串 商户自行生成的随机字符串 32  
signtype 签名类型   8 RSA/SM2
sign 签名 详见安全规范 32  
meruserid 商户用户号   32 商户自定义用户号
accttype 卡类型

00:借记卡

02:准贷记卡/贷记卡

2  
acctno 银行卡号   20  
idtype 证件类型

0:身份证

2:护照

5:港澳通行证

6:台湾通行证

   
idno 证件号   22 如末位是X,必须大写
acctname 户名   20  
mobile 手机号码   11  
validdate 有效期 MMyy 4  
cvv2 Cvv2   4  

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8  
retmsg 返回码说明   100  
randomstr 随机字符串 随机生成的字符串 SUCCESS返回
sign 签名 详见安全规范 32 SUCCESS返回
业务参数 当retcode为SUCCESS时有返回
trxstatus 状态   4  
errmsg 错误信息   100  
thpinfo 交易透传信息   - 如果不为空,则签约申请确认(或者重新触发短信)请原样带上

yinjr 2024年9月3日 14:43 收藏文档