银行卡实名认证接口

核验姓名、身份证号、银行卡号、银行预留手机号四要素是否一致，并返回开户行与卡类型。

请求地址

本接口判断「这张卡是不是这个人的」。四要素缺一不可：姓名、身份证号、银行卡号，再加上银行预留手机号。资金链路里只用三要素是不够的——手机号是银行侧的另一道绑定关系，补上它才能挡住「卡号与姓名都对、但号码不是本人预留」的情况。核验一致时同时返回开户行名称、卡类型与脱敏卡号。

请求参数

请求示例

curl

curl -X POST "https://smrz.anyixing.com.cn/api/v1/bankcard" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL" \
  -d '{"name":"张三","idcard":"330102199001010012","bankcard":"6222021234567894","mobile":"13800138000"}'

PHP

<?php
$payload = '{"name":"张三","idcard":"330102199001010012","bankcard":"6222021234567894","mobile":"13800138000"}';

$ch = curl_init('https://smrz.anyixing.com.cn/api/v1/bankcard');
curl_setopt_array($ch, array(
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_HTTPHEADER     => array(
        'Content-Type: application/json',
        'X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL'
    ),
));
$res  = curl_exec($ch);
curl_close($ch);
$json = json_decode($res, true);
if ($json['code'] === 0) {
    // data.result 为核验结论
}

Python

import requests

resp = requests.post(
    'https://smrz.anyixing.com.cn/api/v1/bankcard',
    json={"name":"张三","idcard":"330102199001010012","bankcard":"6222021234567894","mobile":"13800138000"},
    headers={'X-Api-Key': 'aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL'},
    timeout=10,
)
data = resp.json()
if data['code'] == 0:
    print(data['data']['result'])

返回参数

返回示例

调用成功（业务结论为一致）

{
  "code": 0,
  "msg": "核验一致",
  "data": {
    "result": "MATCH",
    "bank_name": "招商银行",
    "card_type": "储蓄卡",
    "card_mask": "622202****7894",
    "fee": 0.20,
    "balance": 986.20,
    "req_id": "b2c3d4e5f6a7b8c9",
    "cost_ms": 286
  }
}

调用失败（余额不足）

{
  "code": 1003,
  "msg": "余额不足，请充值后重试",
  "data": null
}

核验结论

仅当 code = 0 时存在 data.result。

错误码

计费规则

• 单价按账号累计充值额所属档位执行，起步 ¥0.35 / 次。
• 一致、不一致、卡号不存在均计费。
• 参数错误、鉴权失败、余额不足、防刷拦截、上游异常不计费。

频率与防刷

账号级 QPS 上限为 20，超出返回 1004。除 QPS 外，为防止有人拿真实号码猜姓名、或拿真实姓名批量试号码，另设以下防刷规则，触发返回 1006：

• 同一卡号，60 分钟内出现 ≥5 个不同姓名 → 拦截
• 同一卡号，60 分钟内出现 ≥5 个不同身份证号 → 拦截
• 同一卡号，60 分钟内出现 ≥5 个不同预留手机号 → 拦截
• 同一姓名，60 分钟内查询 ≥10 张不同卡号 → 拦截
• 计数为全局维度，跨账号累计。

注意事项

• 手机号必须是银行预留手机号，填错会得到「不一致」，这是四要素核验的正常结论，同样计费。
• 卡号会先做 Luhn 校验，校验失败的号码在本地被拦截（返回 1001），不计费。
• 返回的卡号一律脱敏，仅保留前 6 位与后 4 位，任何情况下都不返回完整卡号。
• 二类户、三类户同样支持核验，接口按卡号核验归属，不区分账户类别。