主题
银行卡识别
接口描述
通过光学字符识别技术,从银行卡图像中识别出银行卡号及开卡行.
请求说明
HTTP 方法:
POST请求 URL:
/ai-cloud-face/ocr/bankcardHeader如下:
| 参数名称 | 值 |
|---|---|
| Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
| 参数名称 | 必填 | 数据类型 | 长度 | 参数描述 |
|---|---|---|---|---|
| img | 是 | String | 1-3000k | 待处理图片(base64 编码),原始图片大小需要小于 3M; |
| busFlowId | 否 | String | 0-64 | 业务流水号,业务系统唯一序列号(对账用,建议传入) |
请求示例:
{
"img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......"
}返回说明
返回参数:
| 返回值名称 | 数据类型 | 长度 | 描述 |
|---|---|---|---|
| code | int | 1-8 | 返回结果,0表示成功 |
| message | String | 1-255 | 返回码描述 |
| data | Object | - | 返回的数据 |
| -busFlowId | String | 1-64 | 业务流水号,业务系统唯一序列号 |
| -flowId | String | 1-64 | 交易流水ID(建议保存) |
| -bankName | String | 1-32 | 开卡行 |
| -cardNum | String | 1-32 | 卡号 |
| -cardName | String | 1-32 | 卡名 |
| -validDate1 | String | 1-16 | 有效期限1 |
| -validDate2 | String | 1-16 | 有效期限2(若银行卡只有一个有效期,则只返回validDate1;存在两个有效期,才同时返回validDate1和validDate2 |
| -cardType | String | 1-8 | 卡种 |
返回示例:
{
"message": "success",
"code": 0,
"success": true,
"data": {
"bankName": "建设银行",
"cardName": "龙卡储蓄卡(银联卡)",
"cardNum": "6227003818210023672",
"cardType": "借记卡"
}
}错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表
| 码值 | 是否成功 | 是否计费 | 描述 |
|---|---|---|---|
| 00000000 | 是 | 是 | 成功 |
| 50028100 | 否 | 否 | 图片不能为空 |
| 50028103 | 否 | 否 | 图片大小不能超过3M |
| 50028270 | 否 | 否 | 银行卡识别异常 |
| 50028200 | 否 | 否 | 引擎检测异常 |
| 50028201 | 否 | 否 | 引擎检测异常 |