KYC个人身份核验 · 身份核验
港澳台居民居住证识别
IDV046身份核验
支持对港澳居民居住证、台湾居民居住证的正、反面全字段识别，包括姓名、性别、身份证号码、通行证号码等，同时可返回头像切片位置信息，进行头像检测。
核心能力
覆盖多类居住证
支持港澳居民居住证、台湾居民居住证的正、反面识别，适配多类证件场景需求。
全字段精准提取
可提取姓名、性别、身份证号码、通行证号码等正反面全字段信息，满足信息采集需求。
头像信息同步处理
同步返回头像切片位置信息，并支持头像检测，实现证件信息与头像数据的一体化提取。
应用场景
- 01政务服务办理
线上线下办理港澳、台湾居民相关政务业务时，快速识别居住证信息并提取字段，简化资料录入流程，提升办事效率。
- 02金融业务开户
银行、支付机构为港澳、台湾居民办理开户等业务时，通过居住证识别完成身份核验，确保信息准确合规。
- 03酒店入住登记
酒店前台登记时，快速识别居住证正反面信息及头像，实现访客信息快速录入与核验，缩短办理时间。
- 04教育机构入学
学校、培训机构接收港澳、台湾学生时，通过居住证识别提取身份信息，辅助完成入学登记与档案建立。
请求参数
| 字段 | 说明 | 必填 |
|---|---|---|
| image | 证件图片base64编码 | 选填 |
返回字段
| 字段 | 说明 |
|---|---|
| type | 证件类型 |
| image_angle | 图片角度 |
| rotated_image_width | 正方向时图片的宽 |
| rotated_image_height | 正方向时图片高 |
| item_list | 父节点 |
| key | item_list的子节点 |
| value | item_list的子节点 |
| description | item_list的子节点 |
| position | item_list的子节点 |
常见返回码
| 返回码 | 说明 |
|---|---|
| 100000 | 查无记录 |
| 000000 | 交易成功（收费） |
| 200000 | 调用远程数据异常 |
| 200010 | 账号不存在 |
| 200012 | 未找到账号与产品的订购关系 |
| 200013 | 该产品测试条数已用完，请联系羽山数据 |
| 200014 | 加解密错误 |
常见问题
调用前需要做什么准备？
需要在羽山数据开通账号并完成企业实名认证，申请对应产品后获取调用凭证；涉及个人信息的数据服务还需确保已取得信息主体授权。
数据来源与合规性如何保障？
产品接入合规数据源，并要求使用方在合法、正当、必要的范围内使用数据；具体授权要求以产品接入协议与合规提示为准。
接口返回失败时如何排查？
先根据返回的 retcode 与 message 判断是参数、权限还是数据源问题，再核对签名、加密方式与请求体字段；仍无法定位时可联系技术支持并提供请求时间与流水号。
合规提示
使用数据服务的场景应当合理合规。如涉及个人隐私或商业信息，请确保已获得当事人授权，并在合法、正当、必要的范围内使用；不得用于法律法规禁止的用途。