Skip to content

银行卡识别V2


接口描述

通过光学字符识别技术,从银行卡图像中识别出银行卡号及开卡行.

请求说明

HTTP 方法:

POST

请求 URL:

/ai-cloud-face/ocr/v2/bankcard

Header如下:

参数名称
Content-Typeapplication/json;charset=UTF-8

Body中放置请求参数,参数详情如下:

请求参数:

参数名称必填数据类型长度参数描述
imgString1-3000k待处理图片(base64 编码),原始图片大小需要小于 3M;
busFlowIdString0-64业务流水号,业务系统唯一序列号(对账用,建议传入)

请求示例:

{
    "img":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQ......",
    "busFlowId":"uRVJfd594lRwz7m3"
}

返回说明

返回参数:

返回值名称数据类型长度描述
codeString1-8返回结果,00000000表示成功
messageString1-255返回码描述
dataObject-返回的数据
-flowIdString1-64交易流水ID(建议保存)
-busFlowIdString0-64业务流水号,业务系统唯一序列号
-bankNameString1-32开卡行
-cardNumString1-32卡号
-validDateString1-16有效期限
-cardTypeString1-8卡种

返回示例:

{
    "message": "success",
    "code": 0,
    "success": true,
    "data": {
        "busFlowId":"uRVJfd594lRwz7m3",
        "flowId": "1008375977018925056",
        "bankName": "建设银行",
        "cardNum": "6227003818210023672",
        "cardType": "借记卡",
        "validDate":"07/21"
    }
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共CODE码表

码值是否成功是否计费描述
00000000成功
50028100图片不能为空
50028103图片大小不能超过3M
50028270银行卡识别异常
50028200引擎检测异常
80003002识别异常