利用OCR技术识别并返回银行卡相关文本信息

接口说明

该接口目前可返回如下两种识别结果：

• 识别成功：OCR成功识别证件信息，并返回识别出的文字信息字段

• 非银行卡或检测不出银行卡信息：上传的照片为非银行卡照片，或因像素或拍摄角度等原因造成OCR无法识别出银行卡信息。

鉴权说明

易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权

请求

请求地址

名称	值
HTTP URL	https://verify.dun.163.com/v1/ocr/bankcard
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："application/x-www-form-urlencoded"

请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段

名称	类 型	必填	最大长度	描述
image	String	是	4M	BASE64编码，大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/jpeg/png/bmp格式. 注：图片的BASE64编码是不包含图片头的，如（data:image/jpg;BASE64）
detectDirection	String	否	10	是否检测图像朝向：可选值true - 检测朝向；false - 不检测朝向。朝向是指输入图像是正常方向、逆时针旋转90/180/270度

请求体示例

image=xxx&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

响应

响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段

参数名称	类型	必须返回	描述
status	Number	是	1-识别成功 2-图像识别错误 3-图像格式错误 4-其他错误
taskId	String	是	本次请求数据标识，可以根据该标识查询数据最新结果
direction	Number	否	图像方向，当 detectDirection = true 时，返回该参数。 1:未定义 0:正向 -1:逆时针90度 -2:逆时针180度 -3:逆时针270度
isPayed	Number	是	本次请求是否收费标识，1代表收费，0代表不收费
ocrResponseDetail	Object	否	OCR识别信息,结构见下方
∟ bankCardNumber	String	否	银行卡号
∟ validDate	String	否	有效期
∟ bankCardType	Number	否	银行类型 0:不能识别; 1: 借记卡; 2: 贷记卡（原信用卡大部分为贷记卡）; 3: 准贷记卡; 4: 预付费卡;
∟ bankName	String	否	银行名，不能识别时为空

响应体示例

{
  "code": 200,
  "msg": "ok",
  "result": {
    "status": "1",
    "isPayed": 1,
    "taskId": "6faljdfajfajfm0987a",
    "ocrResponseDetail": {
      "bankCardNumber": "6266 0014 8888 88888",
      "validDate": "20/15",
      "bankCardType": 1,
      "bankName": "xx银行"
    },
    "direction": 0
  }
}

响应返回码

响应返回码见：响应返回码