银行卡验证

接口描述

用户通过发送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 系统内部错误
Copyright © 2020 易道博识 all right reserved,powered by Gitbook该文件修订时间: 2026-04-03 09:43:56

results matching ""

    No results matching ""