银行卡要素验证
说明
- 验证银行卡号与持有人姓名、办卡证件、银行卡绑定手机号是否匹配,支持三要素/四要素验证。
- 接口签名方式和短信的接口签名方式保持一致
HTTP头信息
| 参数 | 内容 |
|---|---|
| Accept | application/json;charset=utf-8; |
| Content-Type | application/json;charset=utf-8; |
请求
URL: https://api.moziapi.com/bankcard/verify
请求方式: POST
请求参数
| 参数 | 类型 | 最大长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| bankcard_id | string | 200 | 是 | 银行卡号 |
| name | string | 200 | 是 | 姓名 |
| idcard | string | 200 | 是 | 身份证号 |
| phone_num | string | 200 | 否 | 银行卡绑定手机号 |
参数示例
{
"bankcard_id": "456454554556"
"idcard": "2544554456456356345",
"name": "张三",
"phone_num": "12343435435"
}
响应结果
| 参数 | 类型 | 最大长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| ret_code | Number | 4 | 是 | 调用成功与否,0为成功,其他值为失败 |
| code | Number | 是 | 验证标示 , 取值见下表 | |
| msg | String | 是 | 说明 |
json返回正确参数示例
{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "60d2d8250de3769d4dea27d8",
"showapi_res_body": {
"ret_code": 0,
"code": 0,
"msg": "认证通过"
}
}
code取值:
| code码 | 含义 |
|---|---|
| 0 | 成功 |
| 4 | 此卡被没收,请于发卡方联系 |
| 5 | 持卡人认证失败 |
| 14 | 无效卡号 |
| 15 | 此卡无对应发卡方 |
| 21 | 该卡未初始化或睡眠卡 |
| 34 | 作弊卡,吞卡 |
| 40 | 发卡方不支持的交易 |
| 41 | 此卡已经挂失 |
| 43 | 此卡被没收 |
| 54 | 该卡已过期 |
| 57 | 发卡方不允许此交易 |
| 62 | 受限制的卡 |
| 75 | 密码错误次数超限 |
| 82 | 身份证号码有误 |
| 83 | 银行卡号码有误 |
| 84 | 手机号码输入格式有误 |
| 86 | 持卡人信息有误 |
| 87 | 未开通无卡支付 |
| 96 | 交易失败请重试 |
| 100 | 渠道异常,请稍后再试 |
| 101 | 验证信息重复输入,避免恶意验证请间隔60秒以上再次核验 |
| 103 | 24小时内相同姓名或卡号核验次数超限 |