接口说明
识别银行卡卡号、所属银行、卡种(借记卡/信用卡)、有效期等关键信息。支持国内各大银行发行的银行卡。
平台提供稳定可靠的银行卡识别服务,支持高并发调用,返回JSON格式数据。接口采用RESTful风格设计,接入简单,响应迅速,适用于各类业务场景的快速集成。
适用场景
💳 支付绑卡:自动识别银行卡号快速绑定
🏦 金融业务:银行开户、转账等业务信息采集
📊 财务报销:自动录入银行卡信息用于报销
🔍 卡bin查询:识别发卡行和卡种信息
请求参数
| 参数名 | 类型 | 必填 | 说明 |
| api_key | string | 是 | 用户的API密钥,在个人中心获取 |
| api | string | 是 | 接口标识,本接口为 ocr.bankcard |
| image | string | 是 | 图片Base64编码字符串 |
| text | string | 否 | 文本内容(文本类接口需要) |
返回参数
| 参数名 | 类型 | 说明 |
| code | int | 状态码,200表示成功 |
| message | string | 状态描述 |
| data | object | 业务数据 |
| cost | string | 本次调用费用 |
| balance | string | 调用后账户余额 |
请求示例(PHP)
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, '/index.php?c=ApiGateway&a=call');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'api_key' => 'your_api_key',
'api' => 'ocr.bankcard',
'image' => base64_encode(file_get_contents('test.jpg'))
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
返回示例
{
"code": 200,
"message": "success",
"data": {
"words_result": [
{"words": "识别结果第一行"},
{"words": "识别结果第二行"}
]
},
"cost": "0.03",
"balance": "99.97"
}
错误码说明
| 错误码 | 说明 | 处理建议 |
| 400 | 请求参数错误 | 检查必填参数是否完整 |
| 401 | API Key无效 | 检查密钥是否正确 |
| 402 | 余额不足 | 请先充值 |
| 404 | 接口不存在 | 检查api参数 |
| 500 | 服务器错误 | 稍后重试 |