本文档介绍银行卡识别RecognizeBankCard的语法及示例。

功能描述

RecognizeBankCard可以检测输入的主流银行卡图像，输出3个信息，包括：发卡行、银行卡号、有效日期。

前提条件

请确保您已开通文字识别服务，详情请参见服务开通。

输入限制

  • 图片格式：JPEG、JPG、PNG、BMP、GIF。
  • 图像大小：图像大小不超过3M。
  • 图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值：RecognizeBankCard。
ImageURL String 是 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/3%E9%93%B6%E8%A1%8C%E5%8D%A1.jpg

图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

返回数据

名称 类型 示例值 描述
Data Struct

返回的数据内容。
BankName String 中国工商银行

银行名称，识别失败则返回空字符串。
CardNumber String 6212262315007683105

银行卡号。
ValidDate String 07/26

有效日期，识别失败则返回空字符串。如有多个，则用逗号分隔，例如03/17,04/05。

RequestId String D9C7521-0367-42EE-9646-FD066CCADB26

请求ID。

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeBankCard
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/3%E9%93%B6%E8%A1%8C%E5%8D%A1.jpg
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>FD9C7521-0367-42EE-9646-FD066CCADB26</RequestId>
<Data>
    <CardNumber>6212262315007683105</CardNumber>
    <BankName>中国工商银行</BankName>
    <ValidDate>07/26</ValidDate>
</Data>

JSON 格式 

{
	"RequestId": "FD9C7521-0367-42EE-9646-FD066CCADB26",
	"Data": {
		"CardNumber": "6212262315007683105",
		"BankName": "中国工商银行",
		"ValidDate": "07/26"
	}
}

错误码

关于银行卡识别的错误码，详情请参见常见错误码。

SDK参考

单击SDK简介查看SDK信息。