银行卡OCR
接口描述
- 对上传的银行卡图片进行OCR，返回银行卡信息
接口地址
/v2/identity/auth/api/ocr/bankcard
请求方式
- POST
- 请求报文体采用Json数据格式，编码方式采用UTF-8编码
请求参数
| 参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
|---|---|---|---|---|
| img | 银行卡照片BASE64字符串，注意不要带图片BASE64前缀“data:image/jpeg;base64,”，最大7MB | body | 是 | string |
请求示例
POST /v2/identity/auth/api/ocr/bankcard HTTP/1.1
{
"img": "/9j/4AAQSkZJRgABAQEAS......"
}
响应参数
| 参数名 | 说明 | 类型 |
|---|---|---|
| code | int | 接口响应结果码 |
| message | string | 接口响应结果描述 |
| data | object | 接口响应结果数据 |
| verifyId | string | 业务Id |
| bankCardNo | string | 银行卡号 |
| bankName | string | 银行名称 |
| bankCardType | string | 银行卡类型，借记卡/信用卡/不能识别 |
响应示例
{
"code": 0,
"message": "成功",
"data": {
"verifyId": "fcc8b05c-7f06-4275-a750-4f754070affa",
"bankCardNo": "623xxxxxxxxxxxx979",
"bankName": "杭州商业银行",
"bankCardType": "借记卡"
}
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 30500101 | 参数错误：img不能为空 | 图片BASE64字符串为空 |
| 30500101 | 参数错误：文件大小超出限制，最大7MB | 图片大小超过限制 |
| 30503127 | OCR识别失败 | OCR识别失败 |