接口地址:
生产:https://vsp.allinpay.com/apiweb/qpayol/agreeapply
测试: https://syb-test.allinpay.com/apiweb/qpayol/agreeapply
使用场景:客户发起签约申请,支付参数采用HTTP表单(FORM)方式提交,如果采用get方式提交,需要对字段进行urlencode。编码为UTF-8
返回处理说明:处理成功则跳往渠道银行一键绑卡签约网关,持卡人在银行签约网关完成签约动作
请求参数:
参数 | 参数名称 | 取值 | 可空 | 最大长度 | 备注 |
---|---|---|---|---|---|
orgid | 机构号 | 通联分配的机构号 | 是 | 15 | 共享机构号参数时必填 |
cusid | 商户号 | 通联分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 是 | 2 | 默认填12 |
reqip | 请求ip | 是 | 32 | ||
reqtime | 本次请求时间 | 是 | 16 | yyyyMMddHHmmss | |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | 32 | |
signtype | 签名类型 | RSA/SM2 | 否 | 8 | |
sign | 签名 | 详见安全规范 | 否 | 32 | |
applyid | 申请流水 | 商户平台唯一 | 否 | 32 | |
bankcode | 银行编码 | 见附录 | 否 | 10 | |
encrypttype | 加密方式 |
SM4:国密SM4算法 用于加密证件号户名等敏感信息 |
否 | 8 | |
accttype | 卡类型 |
00:借记卡 02:信用卡 |
否 | 2 | |
idno | 证件号 | 需进行加密传输 | 否 | - | |
idtype | 证件类型 |
0:身份证 1:户口簿 2:护照 3:军官证 4:士兵证 5:港澳通行证 6:台湾通行证 7:临时身份证 8:外国人居留证 9:警官证 X:其他证件 |
否 | 1 | 暂只支持身份证 |
acctname | 户名 | 需进行加密传输 | 否 | - | |
mobile | 手机号 | 需进行加密传输 | 是 | 招行必填 | |
acctno | 卡号 | 需进行加密传输 | 是 | 招行必填 | |
notifyurl | 签约结果后端通知地址 | 接收交易结果通知回调地址,通知url必须为直接可访问的url,不能携带参数。 | 否 | 256 | 用于接口4.2.4 |
returl | 签约结果前端通知地址 | 接收交易结果通知回调地址,通知url必须为直接可访问的url,不能携带参数。 | 否 | 256 | 用于接口4.2.3 |
响应参数:
平台接受到请求后,重定向到网关平台,指引用户完成一键绑卡签约。