4.1.3签约确认


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

使用场景:签约绑卡短信确认
注:签约确认短信验证码有效时间为5分钟

trxstatus 返回处理说明:
0000: 签约成功,流程完成
3999: 签约失败
3058:短信验证码错误
3057:请重新获取验证码
3004: 卡号错误(无法识别卡bin)

请求参数:

参数 参数名称 取值 可空 最大长度 备注
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  
acctname 户名   20  
mobile 手机号码   11  
validdate 有效期 MMyy 4  
cvv2 Cvv2   4  
smscode 短信验证码   10  
thpinfo 交易透传信息   - 签约申请时返回,如果不为空,则原样带上
useragreeno 用户协议号 201    

响应参数:

字段ID 字段名称 取值 可空 最大长度 备注
retcode 返回码 SUCCESS/FAIL 8  
retmsg 返回码说明   100  
randomstr 随机字符串 随机生成的字符串 SUCCESS返回
sign 签名 详见安全规范 32 SUCCESS返回
业务参数 当retcode为SUCCESS时有返回
trxstatus 状态   4  
errmsg 错误信息   100  
agreeid 协议编号   32 状态为0000时返回
bankcode 银行代码   16 状态为0000时返回
bankname 银行名称   100 状态为0000时返回

yinjr 2025年3月27日 12:35 收藏文档