银行卡三要素验证

功能简介

银行卡三要素验证接口，验证姓名、身份证号、银行卡号三项是否匹配。

核心能力：

• 验证姓名、身份证号、银行卡号三项是否匹配
• 支持所有带银联标识的银行卡
• 银联渠道实时校验

适用范围：本 Skill 只覆盖"银行卡三要素验证"接口，不用于其他数据查询场景。

快速开始

只需三步即可开始使用：

运行要求

• 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
• Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
• 能够向 https://openapi.chinaz.net 发起 HTTPS 请求。
• 运行 AI 客户端的环境可读取环境变量。

如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。

获取与配置 API Key

第一步：购买接口

在 银行卡三要素验证接口购买页 购买接口并获取专属 API Key。该接口提供 10元/20次（≈0.5元/次） 的免费体验额度，适合先试用再决定是否购买付费套餐。

第二步：设置环境变量

将 Key 保存为环境变量，变量名必须是：

CHINAZ_BANKCARD_THREE_API_KEY

Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。

macOS / Linux（当前终端会话临时生效）：

export CHINAZ_BANKCARD_THREE_API_KEY='你的专属APIKey'

如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。

第三步：重启生效

重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

安全提醒：不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

参数说明

查询流程

1. 从用户请求中提取查询参数。
2. 在 Skill 根目录执行脚本：

python scripts/query_bankcard_three.py --idcard 110101199001011234 --name 张三 --bankcard 6222021234567890123

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用接口 https://openapi.chinaz.net/v1/1035/bankcard3check，发送请求参数与 ChinazVer 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

返回示例：

{
  "msg": "示例值",
  "success": "示例值",
  "code": "示例值",
  "result": "示例值",
  "desc": "示例值"
}

结果解读

• code: 200 表示查询成功。
• 根据返回字段值判断具体结果，如验证类接口 result: 0 通常表示一致。
• 数据仅供参考，以实际返回为准。

推荐答复格式：

银行卡三要素验证查询结果
- 查询状态：成功 / 失败原因
- msg：返回值
- success：返回值
- code：返回值
- result：返回值
- desc：返回值

错误处理

其他失败状态：按返回的 code 或 JSON 错误信息说明问题，不得编造数据。

使用边界

• 一次只查询单条记录；批量任务须逐条执行。
• 数据仅供参考，以官方数据源为准。
• 不输出、复述或保存 API Key。

应用场景

场景一：基础查询

你会问："帮我查一下银行卡三要素的信息"

操作步骤：

1. 准备好需要查询的关键字。
2. 运行脚本执行查询。

建议输入：python scripts/query_bankcard_three.py --idcard 110101199001011234 --name 张三 --bankcard 6222021234567890123

如何解读结果：查看返回 JSON 中的 msg 字段确认查询是否成功，再查看其他字段获取详细信息。

后续建议：根据查询结果进行下一步业务决策。

场景二：业务分析

你会问："这家企业的银行卡三要素情况如何？"

操作步骤：

1. 确认企业名称或关键字。
2. 运行查询脚本获取数据。

建议输入：python scripts/query_bankcard_three.py --idcard 110101199001011234 --name 张三 --bankcard 6222021234567890123

如何解读结果：综合分析返回的各字段数据，判断企业状况。

后续建议：将查询结果纳入企业信用评估或风险管控流程。

场景三：批量核查

你会问："能不能批量核查多个对象的银行卡三要素验证？"

操作步骤：

1. 虽然接口一次只查一条，但可以编写循环脚本逐条查询。
2. 将结果汇总到表格中进行分析。

建议输入：逐条执行 python scripts/query_bankcard_three.py --idcard 110101199001011234 --name 张三 --bankcard 6222021234567890123

如何解读结果：汇总多条查询结果，进行对比分析。

后续建议：建立定期查询机制，持续监控目标变化。

常见问题

Q：查询返回失败怎么办？

A：首先检查环境变量 CHINAZ_BANKCARD_THREE_API_KEY 是否已正确设置，然后确认 API Key 是否有效、额度是否充足。如果网络不通，检查代理和防火墙设置。

Q：免费额度用完了怎么办？

A：前往银行卡三要素验证购买页购买付费套餐，不同套餐有不同的单次价格，批量使用更优惠。

Q：查询结果和实际不符？

A：数据来源于第三方数据源，可能存在更新延迟。建议以官方渠道数据为准，本接口结果仅供参考。