5 银行卡四要素校验接口
使用说明: 银行卡四要素校验接口可使用于章节服务介绍中的银行卡四要素校验服务中,具体使用步骤请参考银行卡四要素校验服务的时序图。
注意事项: 本接口通过AES加密进行通信。
5.1 功能描述
此接口用于核实输入的银行卡号与姓名、身份证号码与手机号码(银行卡四要素)这四者是否匹配、是否真实有效。
5.2 接口路径
https://rra.tongfudun.com/func/bankcard/verifyfour
5.3 请求方式
POST(application/json)
5.4 提交参数(分为明文数据和明文加密后的数据)
构造的明文数据为:
参数 | 描述 | 备注 |
---|---|---|
name | 身份证姓名 | 必填 |
cid | 身份证号码 | 必填 |
cardno | 银行卡号码 | 必填 |
phone | 手机号码 | 必填 |
构造的密文数据为:
参数 | 描述 | 备注 |
---|---|---|
data | 密文数据 |
5.5 返回参数(分为密文数据和密文解密后的数据)
返回的加密数据为:
status | message | data |
---|---|---|
-100 | 加密数据,请解密后使用 | 密文 |
10031 | 签名校验失败 | |
10052 | 接口密钥通信失败,请联系管理员 | |
10055 | 加密异常,请联系管理员 |
-100状态下对应的密文解密后的数据
status | message | data |
---|---|---|
0 | 身份证银行卡校验通过 | |
-1 | 参数异常 | |
10011 | 服务异常,请联系通付盾管理员 | |
10032 | 该服务尚未开通 | |
10033 | 服务欠费,请充值 | |
4098 | 认证未通过 | |
4001 | 姓名校验不通过 | |
4002 | 身份证号码有误 | |
4003 | (E*)银行卡号码有误 | |
4004 | 手机号码不合法 | |
4005 | 数据校验不通过 | |
4006 | 持卡人信息有误 | |
4007 | 未开通无卡支付 | |
4009 | 此卡被没收 | |
4012 | 无效卡号 | |
4013 | 此卡无对应发卡行 | |
4014 | 此卡为初始卡或睡眠卡 | |
4015 | 作弊卡,吞卡 | |
4016 | 此卡已挂失 | |
4017 | 该卡已过期 | |
4018 | 受限制的卡 | |
4019 | 密码错误次数超限 | |
4023 | 此卡不支持此交易 | |
4099 | 交易失败 |
5.6 示例
请求参数示例
加密前的数据: { "name":"张三", "cid":"13xxxxxxxxxxxxxxxxx", "cardno":"15xxxxxxxxxxxx", } 加密后的数据: { "data":"密文" }返回结果示例
{ "status":"-100", "message":"加密数据,请解密后使用", "data":{}, "aesData":"密文" } 返回密文解密后的数据: { "status":"0", "message":"身份证银行卡校验通过", "data":{} }