银行卡验证
接口描述
用户通过发送HTTP Post请求方式提交数据至公有云服务器,服务器识别并返回json格式的识别结果。
接口说明
请求URL:http://api.exocr.com/data/v1/verify_bank_card
请求方式:HTTP Post
返回格式:json
API 定义
ocr/v1/temp_id
请求参数
| 字段 | 必选 | 类型 | 说明 |
|---|---|---|---|
| app_key | 是 | string | 请在控制台->我的应用中获取 |
| app_secret | 是 | string | 请在控制台->我的应用中获取 |
| bank_card_no | 是 | string | 银行卡卡号 |
| personal_name | 是 | string | 姓名 |
| identity_card_no | 是 | string | 身份证号码 |
| phone_no | 否 | string | 电话号码。可选参数,需要四要素认证时传此参数,三要素认证时则不需传此参数。 |
| document_type | 否 | string | 证件类型枚举值如下: 02 护照 04 台胞证 05 军官证 06 警官证 07 士兵证 08 旅行证 09 外国护照 10 其他 11 回乡证 12 港澳居民居住证 13 台湾居民居住证 14 港澳居民来往内地通行证 15 外国人永久居留身份证 16 出入境通行证 17 内地居民来往港澳通行证 |
调用示例
java(相关依赖库下载)
package com.exocr.httpclient;
import java.io.FileNotFoundException;
import java.util.HashMap;
import java.util.Map;
import com.exocr.common.utils.HttpClientUtils;
public class Test {
public static void main(String[] args) throws FileNotFoundException {
//识别url
String url = "http://api.exocr.com/data/v1/verify_bank_card";
//设置请求参数
Map<String, String> params = new HashMap<String, String>();
params.put("app_key", "#####");
params.put("app_secret", "#####");
// 三要素
params.put("bank_card_no", "##########");
params.put("personal_name", "张三");
params.put("identity_card_no", "##########");
// 四要素
// params.put("bank_card_no", "##########");
// params.put("personal_name", "张三");
// params.put("identity_card_no", "##########");
// params.put("phone_no", "######");
// params.put("document_type", "######");
//发送请求,得到识别结果
String string = HttpClientUtils.doPost(url, params);
System.out.println(string);
}
}
返回示例
{
"result": {
"desc": "认证一致",
"result_code": 20000
},
"error_code": 0,
"description": "调用成功",
"request_id": "EE933E22A02B47ABAAE2025E7A8AE93A",
"recognize_time": 25388,
"available_count": 21,
"version": null,
"rotation": null
}
返回结果
通用参数
| 参数 | 类型 | 说明 |
|---|---|---|
| result | array | 返回结果数组 |
| error_code | int | 错误码,返回0为正确,其他为错误 |
| description | string | 识别结果描述 |
| request_id | string | 请求编号 |
| recognize_time | int | 识别所用时间,单位为毫秒 |
| available_count | int | 识别剩余可用次数,次数不足时无法继续识别,可在控制台进行充值次数 |
银行卡认证特有参数
| 参数 | 类型 | 说明 |
|---|---|---|
| desc | string | 认证结果描述 |
| result_code | int | 认证结果码(枚举值为下表) |
认证结果码
| 结果码 | 类型 | 说明 |
|---|---|---|
| 20000 | int | 认证一致 |
| 20502 | int | 认证不一致,持卡人信息有误 |
| 20501 | int | 认证不一致,无效卡号 |
| 20514 | int | 认证不一致,卡状态异常 |
| 20591 | int | 认证不一致,身份证号码数据有误 |
| 20590 | int | 认证不一致,姓名数据有误 |
| 20593 | int | 认证不一致,银行卡号数据有误 |
| 20503 | int | 认证不一致,手机号码有误 |
| 20510 | int | 认证不一致,发卡行不支持此交易 |
| 20505 | int | 认证不一致,交易次数超限 |
| 3009 | int | 超过当日查验次数限制 |
| 3102 | int | 请求银联数据失败 |
| 3107 | int | 交易超时 |
| 3108 | int | 请求数据有误 |
| 3109 | int | 该卡暂不支持认证 |
| 3101 | int | 系统内部错误 |