银行卡OCR

接口描述

对上传的银行卡图片进行OCR识别，返回银行卡信息

接口

/v2/identity/auth/api/ocr/bankcard

请求方式

POST

请求头

提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	项目ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	否	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情。

请求参数

参数名称

类型

必选

参数类型

参数说明

img

string

是

body

银行卡正面照照片base64数据。

注意不要带图片BASE64前缀“data:image/jpeg;base64,”

图片类型支持：jpg，jpeg，png，bmp

图片建议分辨率为1024*768，图片大小控制在3M以内

响应参数

展开全部参数参数名称		类型	必选	参数说明
code		int	是	接口响应结果码
message		string	否	接口响应结果描述
data		object	否	接口响应结果数据
	verifyId	string	否	业务Id
	bankCardNo	string	否	银行卡号
	bankName	string	否	银行名称
	bankCardType	string	否	银行卡类型，类型包含3种：“借记卡”、信用卡”以及“不能识别”

请求示例

{
    "img": "/9j/4AAQSkZJRgABAQEAS......"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "fcc8b05c-7f06-4275-a750-4f754070affa",
        "bankCardNo": "623xxxxxxxxxxxx979",
        "bankName": "杭州商业银行",
        "bankCardType": "借记卡"
    }
}

错误码

错误码	错误描述	解决方案
30500101	参数错误：img不能为空	图片BASE64字符串为空
30503127	OCR识别失败	OCR识别失败