银行卡识别

接口说明

[!NOTE]
君子签提供OCR银行卡识别,通过上传银行卡照片识别银行卡号。该接口涉及到ocr银行卡识别费用,如果未购买需要联系商务进行购买。

http请求方式

[!NOTE]
POST multipart/form-data

http请求地址

[!NOTE]
$SERVICE_URL/v2/ocr/ocrBank #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外,还需要传以下参数

参数 类型 是否必填 默认值 说明
file file ? 图片file,图片不能超2mb,图片分辨率不能超4k,file和imgHttpUrl有且只有一个上传
imgHttpUrl string ? 图片url地址,图片不能超2mb,图片分辨率不能超4k
isCompress string ? 是否进行图片压缩(是0,否1,如果压缩图片则可能会影响识别效率),默认为0

代码实现

JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("file", new FileBody(new File("/tmp/bank.png")));//也可用FileBody
//params.put("isCompress",0);
ResultInfo<Map<String,Object>> ri= requestUtils.doPost("/v2/ocr/ocrBank",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "file" => new CURLFile('D:/tmp/iden.png',null,"test.png"),
    "isCompress" => 0 //0压缩1不压缩,默认0
    //"imgHttpUrl" => "http://xxx.xxx.xxx"
);
//发起请求
$response=$requestUtils->doPost("/v2/ocr/ocrBank",$request);

http返回参数

[!NOTE]
返回response为application/json的数据,其字段说明如下

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode string ? 异常时返回
data object ? 业务信息

[!NOTE]
data字段说明如下

参数 类型 是否必返回 说明
cardNo string * 银行卡号
bankName string * 发卡行名称
orderNo string * 流水号
executeStatus int * 执行状态(0:success;1:fail)
resultMessage string * 返回信息
validDate string * 银行卡有效期

[!NOTE]
返回结果,参考:

//正确响应:
{"data":{"bankName":"农业银行","cardNo":"62284804XXXXXXXXXX","executeStatus":0,"orderNo":"565354D46FE1451F8256A58132415278","resultMessage":"success","validDate":"NO
VALID"},"success":true}


//错误响应:
{"msg":"识别银行卡错误","resultCode":"BUSINESS_ERROR","success":false}

results matching ""

    No results matching ""