能力说明
银行卡四要素核验用于确认「这张卡确实属于这个人」。姓名、身份证号、卡号之外，还要比对银行预留手机号——资金链路里只做三要素不够，号码是银行侧独立的绑定关系，补上它才挡得住「卡和人都对、号不是本人」的情况。接口同时返回卡所属银行与卡类型，便于业务侧做展示与路由。
接口不返回、不存储任何明文证件信息。每次调用仅留存结果码、耗时与流水号，用于对账与排障。
核验结论
| result | 含义 | 说明 |
|---|---|---|
| MATCH | 一致 | 四要素校验通过，卡归属此人与该预留号 |
| NO_MATCH | 不一致 | 四要素中至少一项不匹配（含预留手机号不符） |
| NO_CARD | 卡号不存在 | 银行卡号无效或已注销 |
接口说明
完整的请求参数、返回字段与多语言示例见 银行卡实名认证接口文档。
POST/api/v1/bankcard
Content-Type: application/json
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name* | string | 是 | 姓名，中文全名 |
| idcard* | string | 是 | 18 位居民身份证号 |
| bankcard* | string | 是 | 银行卡号，12-19 位数字 |
| mobile* | string | 是 | 银行预留手机号，11 位 |
请求示例
curl -X POST "https://smrz.anyixing.com.cn/api/v1/bankcard" \ -H "Content-Type: application/json" \ -H "X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL" \ -d '{"name":"张三","idcard":"330102199001010016","bankcard":"6222021234567890123","mobile":"13800138000"}'
返回示例
{
"code": 0,
"msg": "核验一致",
"data": {
"result": "MATCH",
"fee": 0.35,
"balance": 4986.40,
"req_id": "a1b2c3d4e5f6a7b8",
"cost_ms": 218
}
}
适用场景
这些环节都能用上
1
提现绑卡校验
用户绑定收款卡时校验归属，避免提现到他人账户引发纠纷。
2
代付下发前核验
批量代付前校验收款账户，降低打款失败与退款成本。
3
企业付款白名单
对公付款前核验账户实名，防范账户信息被篡改。
4
风控二次校验
异常交易触发时核验持卡人身份，作为风控决策输入。
常见问题
你可能关心的问题
手机号填错了会怎样？
返回「不一致」。四要素要求预留手机号也必须匹配，这是正常业务结论，同样计费。
会返回银行卡的完整卡号吗？
不会。返回结果中卡号一律脱敏，仅保留前 6 位与后 4 位，用于展示与核对。
二类户、三类户能核验吗？
可以。接口按卡号核验归属，不区分账户类别。
核验「不一致」会扣费吗？
会。业务性判断（一致 / 不一致）均视为一次有效核验；仅网络异常、上游故障等非业务失败不计费。
