接口描述
身份证OCR识别认证
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/idCardAuth/ocr
测试调用地址
敬请期待
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情参考“获取token”接口中的应答参数token的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分 | |||
| 时间戳 | ts | string | M-必填 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 业务方账户 | appId | string | M-必填 |
|
|||
| 业务方密码 | appPwd | string | M-必填 |
|
|||
| 身份证正面 | frontImage | string | M-必填 | 身份证正面base64数据
|
|||
| 身份证反面 | backImage | string | C-按条件必填 | 身份证反面base64数据，cardSide为0时必选
|
|||
| 正反面 | cardSide | string | M-必填 | 身份证正反面，1：正面； 0：正反面
|
|||
| 手持身份证 | isInHand | string | M-必填 | 是否为手持身份证，1：是； 0：不是
|
|||
| 是否返回身份证图片 | cardInfoCallback | string | M-必填 | 是否返回身份证信息 1：返回； 0：不返回
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | R-需要返回 |
|
|||
| 应答消息 | respMsg | string | R-需要返回 |
|
|||
| 应答报文 | data | map | R-需要返回 |
|
示例代码
{
"respCd": "00",
"respMsg": "成功",
"data": {
"code": "00",
"msg": "成功",
"data": {
"cardInfo": {
"birthday": "1992XXXX",
"address": "福建省晋江市XXXXXXXXX",
"nationality": "汉",
"sex": "男",
"name": "XXX",
"idNum": "3505821992XXXXXXXX"
},
"err_no": "认证成功",
"err_msg": "0X"
}
}}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
