银行卡识别

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeBankCard

系统规定参数。取值:RecognizeBankCard

Url String https://xxdomain/xxx.jpg

图片链接(长度不超 2048,不支持 base64)

String 图片二进制文件

图片二进制文件,最大10MB,与URL二选一。 使用HTTP方式调用,把图片二进制文件放到HTTP body 中上传即可。 使用SDK的方式调用,把图片放到SDK的body中即可。

返回数据

名称 类型 示例值 描述
RequestId String 43A29C77-405E-4CC0-BC55-EE694AD00655

请求唯一 ID

Data String {"data":{"银行":"交通银行","银行卡号":"622262137000078xxxx","有效期至":"YYYY/MM","卡种":"DC"},"ftype":0,"height":2139,"orgHeight":2139,"orgWidth":3116,"prism_keyValueInfo":[{"key":"银行","keyProb":100,"value":"交通银行","valuePos":[{"x":374,"y":169},{"x":1344,"y":143},{"x":1350,"y":344},{"x":379,"y":370}],"valueProb":100}],"sliceRect":{"x0":0,"y0":0,"x1":3110,"y1":30,"x2":3116,"y2":2066,"x3":0,"y3":2139},"width":3116}

返回数据

Code String 200

状态码

Message String message

详细信息

示例

请求示例

http(s)://[Endpoint]/?Action=RecognizeBankCard
&Url=https://img.alicdn.com/tfs/TB1Wo7eXAvoK1RjSZFDXXXY3pXa-2512-3509.jpg
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeBankCardResponse>
    <RequestId>9FD243AA-D0C9-4E37-B200-6B7B87B5AA32</RequestId>
    <Data>{"data":{"bankName":"交通银行","cardNumber":"6222621370000783456","validToDate":"2024/12","cardType":"DC"},"ftype":0,"height":2139,"orgHeight":2139,"orgWidth":3116,"prism_keyValueInfo":[{"key":"bankName","keyProb":100,"value":"交通银行","valuePos":[{"x":374,"y":169},{"x":1344,"y":143},{"x":1350,"y":344},{"x":379,"y":370}],"valueProb":100},{"key":"cardNumber","keyProb":100,"value":"6222621370000783456","valuePos":[{"x":103,"y":1253},{"x":3011,"y":1137},{"x":3021,"y":1370},{"x":112,"y":1486}],"valueProb":100},{"key":"validToDate","keyProb":100,"value":"2024/12","valuePos":[{"x":1347,"y":1573},{"x":2074,"y":1554},{"x":2077,"y":1698},{"x":1351,"y":1718}],"valueProb":100},{"key":"cardType","keyProb":100,"value":"DC","valuePos":[{"x":437,"y":445},{"x":1316,"y":433},{"x":1318,"y":541},{"x":439,"y":553}],"valueProb":100}],"sliceRect":{"x0":0,"y0":14,"x1":3116,"y1":0,"x2":3116,"y2":2050,"x3":0,"y3":2139},"width":3116}</Data>
</RecognizeBankCardResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9FD243AA-D0C9-4E37-B200-6B7B87B5AA32",
  "Data" : "{\"data\":{\"bankName\":\"交通银行\",\"cardNumber\":\"6222621370000783456\",\"validToDate\":\"2024/12\",\"cardType\":\"DC\"},\"ftype\":0,\"height\":2139,\"orgHeight\":2139,\"orgWidth\":3116,\"prism_keyValueInfo\":[{\"key\":\"bankName\",\"keyProb\":100,\"value\":\"交通银行\",\"valuePos\":[{\"x\":374,\"y\":169},{\"x\":1344,\"y\":143},{\"x\":1350,\"y\":344},{\"x\":379,\"y\":370}],\"valueProb\":100},{\"key\":\"cardNumber\",\"keyProb\":100,\"value\":\"6222621370000783456\",\"valuePos\":[{\"x\":103,\"y\":1253},{\"x\":3011,\"y\":1137},{\"x\":3021,\"y\":1370},{\"x\":112,\"y\":1486}],\"valueProb\":100},{\"key\":\"validToDate\",\"keyProb\":100,\"value\":\"2024/12\",\"valuePos\":[{\"x\":1347,\"y\":1573},{\"x\":2074,\"y\":1554},{\"x\":2077,\"y\":1698},{\"x\":1351,\"y\":1718}],\"valueProb\":100},{\"key\":\"cardType\",\"keyProb\":100,\"value\":\"DC\",\"valuePos\":[{\"x\":437,\"y\":445},{\"x\":1316,\"y\":433},{\"x\":1318,\"y\":541},{\"x\":439,\"y\":553}],\"valueProb\":100}],\"sliceRect\":{\"x0\":0,\"y0\":14,\"x1\":3116,\"y1\":0,\"x2\":3116,\"y2\":2050,\"x3\":0,\"y3\":2139},\"width\":3116}"
}

返回示例补充说明

### 中英文字段映射
bankName  银行  
cardNumber  银行卡号
validToDate   有效期至
cardType       卡种

错误码

访问错误中心查看更多错误码。