银行卡二要素验证

要解决的问题

实名认证、支付绑卡、信贷风控等场景里，"姓名 + 银行卡号"是最常被核对的一组信息。人工核验成本高，而且姓名与卡号是否真实对应，肉眼无法判断。这个技能解决的问题很具体：在代码里用一次调用，确认给定的 name 与 bankcard 是否属于同一持卡人。

核心能力与工作方式

• 银联渠道实时校验，不是本地规则库比对；
• 准确率标称 99%，覆盖所有带银联标识的银行卡；
• 技能只封装"银行卡二要素验证"这一个接口，不做其他数据查询。

调用方式：在 Skill 根目录执行 scripts/query_bankcard_two.py，通过 --name 和 --bankcard 传入两个必填参数；也可以预先配置环境变量 CHINAZ_BANKCARD_TWO_API_KEY，脚本会自动读取。脚本把参数连同 Key 提交到接口，并返回 JSON 结果。

结果解读看几个字段：code 为 200 表示查询成功；result 是结论——0 一致、1 不一致、2 未认证、3 已注销；msg 和 desc 是说明文本。出错时常见三类情况：缺少 Key（missing_api_key），需要用户提供在购买页获取的专属 Key；参数格式错误（invalid_input）；网络问题（network_error / timeout）。

适用边界与注意点

• 一次只能查 单条记录，批量需求要用循环逐条执行；
• 数据来自第三方数据源，可能存在更新延迟，结果仅供参考，以官方渠道为准；
• API Key 不应被输出、复述或持久化保存；
• 调用受配额限制，免费额度用完后需购买付费套餐。