身份证与银行卡实名核验服务（功能与使用指南）
一、功能特点
| 特性 | 说明 |
|---|---|
| 接入点覆盖 | 身份证二要素、银行卡二要素、银行卡三要素、银行卡四要素 |
| 请求方式 | POST/GET，HTTPS 传输 |
| 返回格式 | JSON，字段清晰 |
| 响应速度 | 毫秒级 |
| 适用对象 | 企业用户 |
| 数据更新 | 依据官方数据源实时更新 |
二、操作流程
步骤 1：开通服务
访问对应阿里云市场服务页，选择对应规格完成开通，获取调用凭证。
步骤 2：获取密钥
进入控制台查看 AppKey 与密钥，用于接口鉴权。
步骤 3：选择接入点
根据业务需要选择对应接入点：
| 接入点 | 输入参数 | 返回重点 |
|---|---|---|
| 身份证二要素 | name、idcard | code、msg、sex、birthday、province、city、county、address |
| 银行卡二要素 | name、bankcard | code、msg、bankName、cardType |
| 银行卡三要素 | name、idcard、bankcard | code、msg、一致性结果 |
| 银行卡四要素 | name、idcard、bankcard、phone | code、msg、一致性结果 |
步骤 4：发起调用
构造 HTTPS 请求，按接入点传入必填字段，提交核验。
步骤 5：解析结果
根据返回的 code 与 msg 判断核验状态，并将附加信息用于业务流程。
常见返回状态说明：
0：匹配1：不匹配2：无此身份证号码12：身份证号码不合法101：重复提交，请间隔 60 秒以上103：24 小时内相同姓名或卡号核验次数超限
三、实际案例
案例 1：身份证二要素核验
用户输入姓名和身份证号后，服务返回核验结果及性别、生日、籍贯等附加信息。
案例 2：银行卡二要素核验
输入姓名与银行卡号，核验姓名与卡号是否一致，并返回发卡行与卡类型。
案例 3：银行卡四要素核验
输入姓名、身份证号、银行卡号、预留手机号，四要素全部一致时返回核验通过。
四、在线运行实录
场景设计
以“新用户注册实名认证”为例，调用身份证二要素核验接口，确认用户提交的姓名与身份证号是否真实匹配。
请求参数
| 参数 | 值 | 说明 |
|---|---|---|
| name | 王*五 | 用户真实姓名 |
| idcard | 631698**6825 | 用户身份证号 |
运行过程
- 打开服务在线调试页面。
- 选择“身份证二要素核验”接入点。
- 在 name 与 idcard 字段填入测试数据。
- 点击“发送请求”。
- 系统实时返回核验结果。
返回结果
返回示例中 code 为 0，msg 为“匹配”，同时附带性别、生日、省市区等详细信息，可直接写入用户档案或展示给前端。
五、内容小结
本篇介绍了身份证与银行卡实名核验服务的功能特点、标准接入流程及三类典型核验案例。企业用户可根据业务安全需求选择二要素、三要素或四要素接入点，通过标准 HTTPS 接口快速完成身份真实性校验。
使用过程中请注意：
- 测试数据不要频繁错误提交，避免触发风控限制。
- 同一姓名或卡号 24 小时内重复核验次数有限制。
- 身份证号位数明显错误时会被计为无效请求。
- 请妥善保管调用密钥，避免在客户端暴露。
如需开通或查看详细规格，请前往对应服务页：
