技能介绍

这个技能解决什么问题

在支付签约、实名认证等场景里，程序需要确认“这个身份证号、姓名、银行卡号、预留手机号”是否属于同一个人。人工核对既慢又容易出错，自己对接银联或数据源又要处理鉴权、报文和渠道差异。银行卡四要素验证 把这一步收敛成一个接口：传入四项信息，返回是否一致。

适合需要做开户、绑卡、风控初审的后端服务；如果你只是想查银行卡归属行、卡类型，或做企业工商数据查询，这个 Skill 并不适合。

它如何工作

核心能力是校验 idcard、name、bankcard、mobile 四项是否匹配，底层走银联渠道实时校验。使用时需要先在购买页获取专属 API Key，把 Key 交给 AI 或配置为环境变量 CHINAZ_BANKCARD_FOUR_API_KEY，再运行技能根目录下的脚本：

脚本会携带 ChinazVer 与 APIKey 调用接口；
从返回 JSON 中读取 code、result、msg、desc；
code: 200 表示查询成功，result: 0 通常表示四要素一致，1 不一致，2 未认证，3 已注销；
其他返回码或错误信息按实际内容回复，不做推测。

实际流程可以拆成三步：从用户请求里提取四个参数；执行 python scripts/query_bankcard_four.py --idcard ... --name ... --bankcard ... --mobile ...；把脚本输出转成业务结论。

适用边界与注意点

一次只查单条记录，批量需求必须写循环逐条执行；
返回结果仅供参考，最终以官方数据源为准；
不要在对话、日志或文件中输出、复述或保存完整 API Key；
常见失败包括 missing_api_key、invalid_input、network_error / timeout，分别对应补 Key、检查参数格式、排查网络代理或防火墙；
如果 Key 无效或额度不足，需要回到购买页检查或续费，不要自行编造验证结论。