本文档介绍银行卡识别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信息。