银行卡 OCR

支持多种异形银行卡识别，包括平字、凸字、小卡以及竖卡等，并返回发卡行和卡类型等信息。

产品概述

用于识别通过接口上传的银行卡图片上的卡号和相关信信息。

接口说明

  • 请求地址：由服务方提供
  • 请求方式：HTTP POST
  • 请求格式：application/x-www-form-urlencoded
  • 响应格式：application/json
  • 超时时间：默认 10s

照片说明

  1. 支持 jpg、jpeg、bmp、png、tiff 格式
  2. 照片像素不宜太低
  3. 请勿反光、污损、模糊
  4. 请勿强曝光、逆光、背光
  5. 宽高 8px～5000px
  6. 文件 ≤ 5 MB

请求参数

参数描述是否必填说明
parMerCode主商户号是商户一级账号，由服务方提供
merAcct商户账号是商户二级账号，由服务方提供
appKey商户密钥否加签所需密钥，由服务方提供，入参不传此值
productType产品类型是见各接口附录
merserialNo商户流水号否最长 36 位，建议上送便于双方查询交易
signature签名值是报文加签后的值，见通用约定
imageBase64图片 base64 码是需 OCR 的银行卡图片 base64

请求示例

POST 请求体为 application/x-www-form-urlencoded（非 JSON），appKey 不入参。Body 示例：

parMerCode=主商户号&merAcct=商户账号&productType=PIB&merserialNo=商户流水号&imageBase64=照片base64码&signature=加签后的签名值

响应参数

参数描述是否必返说明
respCode返回码是见各接口附录
respMsg返回信息是见各接口附录
datadata 数据域是返回请求信息及我司订单号

data 数据域

子参描述是否必返说明
parMerCode主商户号是原样返回
merAcct商户账号是原样返回
productType产品类型是原样返回
transCode交易流水号否我司交易流水号（订单号）

datarow 数据域

子参描述是否必返说明
card_no银行卡号否
bank_name发卡行名称否
card_name卡片名称否
card_type卡片类型否
valid_thru有效期否

应答示例

{
  "respCode": "PIB00",
  "respMsg": "识别成功",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PIB",
    "transCode": "交易流水号"
  },
  "datarow": {
    "card_no": "银行卡号",
    "bank_name": "发卡行名称",
    "card_name": "卡片名称",
    "card_type": "卡片类型"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PIB银行卡 OCR

返回码及信息字典

返回码返回信息是否计费
PIB00识别成功是
PIB01图片无法识别否
PIB02系统异常否
PS图片大小不正确否
PI图片不合法否
ER交易异常否
OT交易超时/资源方超时否
SE系统异常否
DE请求数据有误否
SF验签失败否
PD权限不足否
AR账户余额不足否

加签说明与完整调用 Demo 见通用约定。

营业执照 OCR
识别营业执照上的文字信息，包括统一社会信用代码、公司名称、地址等信息并返回结构化结果。
身份证 OCR
识别静态身份证图片上的文字信息，可自动校正透视变形图像，支持任意方向、正反图像自动识别。