银行卡识别接口（bankcard.ocr）：卡号 + BIN + 发卡行等字段

这个接口能解决什么问题

bankcard.ocr 把「绑卡录卡号」拆成一次 HTTP 请求。相比传统固定模板 OCR 遇到凸字反光就串行，本接口不依赖固定模板与定位框，能理解卡面版式与上下文语义，对轻微模糊、倾斜、反光、非标准拍摄角度的卡片同样有效；卡号逐位核对，拿不准就返回空字符串而不是猜测值，并给出置信度与质量提示，方便业务侧决定直接采信或转人工复核。卡号前 6 位 BIN 由服务端按卡号推导，不依赖模型输出。

一句话说明

上传银行卡照片，一次返回卡号 + BIN + 发卡行等字段 + 置信度；调用即计费，识别失败同样扣费。

适用场景

支付绑卡、钱包开户
商户进件与结算账户录入
报销打款账户采集
代发工资卡号采集、企业付款与供应商账户维护

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/bankcard/ocr`
请求方式	POST；支持 multipart/form-data（file 字段）、application/json（image base64）、远程图片地址（imageUrl）
鉴权方式	请求头 `X-API-Key`
接口编码	`bankcard.ocr`
收费类型	按次计费（PER_CALL，0.0500 元/次）
计费规则	调用即计费：图片通过校验进入识别流程后，无论成功或失败都计一次费用；未传图片、超 10MB、格式不支持不扣费
图片限制	单张 ≤ 10MB，支持 JPG / PNG / WEBP / BMP / GIF
典型耗时	通常 2 ~ 8 秒
典型用途	支付绑卡、钱包开户、商户进件、账户录入

如何调用

cURL（multipart 上传文件）

curl -s -X POST "https://api.xujian.tech/openapi/bankcard/ocr" -H "X-API-Key: 你的APIKey" -F "file=@/path/to/bankcard.jpg"

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "cardNo": "6225881234567890",
    "bin": "622588",
    "bankName": "招商银行",
    "cardType": "借记卡",
    "cardOrg": "银联",
    "cardLevel": "金卡",
    "cardName": "一卡通",
    "holderName": "张三",
    "validDate": "12/28",
    "overallConfidence": 0.97,
    "apiCode": "bankcard.ocr",
    "apiName": "银行卡识别",
    "chargeType": "PER_CALL",
    "balance": 99.9500,
    "costMs": 2600
  }
}

计费说明

按次计费，0.0500 元/次，调用即计费。图片通过校验进入识别流程后，无论识别成功还是失败（模糊无法识别 / 不是银行卡 / 上游超时）都计一次费用；只有未传图片、超过 10MB、格式不支持这类参数级错误返回失败且不扣费。卡号 BIN 由服务端按卡号推导，不依赖模型输出，更稳定。

常见问题

BIN 怎么来的？ 由服务端按识别出的卡号前 6 位推导，比模型直接输出更可靠。
卡号识别不准怎么办？ 卡号逐位核对，拿不准返回空字符串并给出置信度，业务侧可据此转人工复核。
识别失败也计费吗？ 是的，属于「调用即计费」口径；上传前请确保图片清晰、是银行卡卡号面。