身份证 OCR

识别静态身份证图片上的文字信息，可自动校正透视变形图像，支持任意方向、正反图像自动识别。

产品概述

用于识别通过接口上传的静态身份证图片上的文字信息。

接口说明

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

照片说明

  1. 支持 jpg、jpeg、bmp、png 格式
  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=PIO&merserialNo=商户流水号&imageBase64=照片base64码&signature=加签后的签名值

响应参数

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

data 数据域

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

datarow 数据域

子参描述是否必返说明
face身份证正反面标识是front 正面，back 国徽面
name姓名（正面）是
gender性别（正面）是
nationality民族（正面）是
year出生年（正面）是
month出生月（正面）是
day出生日（正面）是
address地址（正面）是
idno身份证号（正面）是
issued签发机关（反面）否
valid有效期限（反面）否

应答示例

{
  "respCode": "PIO00",
  "respMsg": "识别成功",
  "data": {
    "parMerCode": "主商户号",
    "merAcct": "商户账号",
    "productType": "PIO",
    "transCode": "交易流水号"
  },
  "datarow": {
    "face": "front",
    "name": "姓名",
    "gender": "性别",
    "nationality": "民族",
    "year": "出生年",
    "month": "出生月",
    "day": "出生日",
    "address": "地址",
    "idno": "身份证号"
  }
}

附录

产品类型字典

产品类型枚举值产品类型含义
PIO身份证 OCR

返回码及信息字典

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

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

银行卡 OCR
支持多种异形银行卡识别，包括平字、凸字、小卡以及竖卡等，并返回发卡行和卡类型等信息。
工商实名二要素
通过企业名称与统一社会信用代码/注册号一致性核验企业身份。