生产接口地址: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 | 交易透传信息 | 是 | - | 如果不为空,则签约申请确认(或者重新触发短信)请原样带上 |