一个产品，替代一台设备

身份证NFC读卡把“读身份证”从一台专用设备，变成手机里的一个动作。用户把证件贴在手机背面，随后拿到可以直接用于办理业务的结构化身份信息。

三种方式对比

产品由什么组成

上图是组成与数据流向。终端侧只做两件事——感应证件、上送密文；App 侧也只做两件事——接收回调、落到业务里。中间的鉴权、解码与计次全部由平台承担，客户不必自己实现解码逻辑。

核心功能

功能按“客户能感知到什么”来讲，不按接口顺序来讲。五项能力互相支撑，缺一项都会让某类场景落不了地。

芯片级读卡，读的是证不是图

NFC 读卡取的是二代身份证芯片内的数据，不是证件表面的照片。芯片数据受卡片安全机制保护，读出来的是密文，必须经授权解码才能成为可读字段。

这带来两个直接结果。一是录入不再依赖光线、角度和字样清晰度，反光、折痕和磨损都不影响结果；二是能判断这张证件是不是真的——芯片能正常响应并解出合法数据，本身就是一次验证。

边界也要说清：读芯片证明的是“证件为真、信息准确”，不能证明“持证的人就是本人”。要确认人证一致，需要再接一步人脸比对。平台的人脸核验与活体检测能力可以直接串在同一次核验流程里，客户不必分别对接两套系统。

云解码，把密文变成能用的字段

终端上送密文，平台解码后按统一结构返回。字段沿用二代证芯片的标准内容，客户拿到的是一张可以直接落库的记录。

字段集以实际接口返回为准。同一接口预留了旅行证件类型位（type=2），后续可随通道能力扩展，客户的接入方式不需要跟着改。

Android 与 iOS 双端接入

目前覆盖 Android 与 iOS 两端。Android 按包名识别应用，iOS 按 bundleId 识别，接入时按端传入对应参数即可。对已有 App 的客户，接入相当于增加一个模块，登记页与受理页不必重做。

读卡动作依赖手机自带 NFC 硬件，机型与系统版本的实际支持范围建议在联调阶段逐型号核对；对没有 NFC 的设备，可以保留 OCR 作为兜底，两条链路共用同一套结果字段。

计次与对账

账户按可用次数管理。调用前可以先校验余量，解码完成后随结果回传计费状态与计费条数，客户侧按 requestId 就能对上账——哪一次计费、计费几条，都有记录可查，不存在“读成功了却说不清有没有扣费”的情况。

结果通过 SDK 回调返回

解码完成后，结果由 SDK 回调直接交给 App 里的业务代码。客户不需要额外提供回调地址，也不必自建接收服务，少一个服务就少一处运维和排障。

回调里同时带回本次计费状态，业务代码拿到结果就可以进入比对与办理。需要注意的是，回调发生在客户端，完整明文不建议长时间留在前端，也不建议写进日志。

工作原理

把一次核验拆成六个环节，客户能看清自己的代码要在哪里接、接完要做什么。六个环节里只有第一个需要人参与，其余由 SDK 与平台自动衔接。

同一条信息，在链路上换三次形态

身份信息不是一路明文走到底的。理解这几次形态变化，客户的架构设计与安全设计才有依据。

异常怎么返回，怎么处理

接口层用 200000 表示请求成功，业务层用 data.code 区分具体原因。下面几种是联调阶段最常遇到的。

使用场景

场景很多，核验动作只有一种。下面先按“核验发生在哪里”分三类，再给一张逐场景的做法对照。

逐场景对照

和人脸核验串起来用

读证解决“证件真伪与信息准确”，人脸解决“是不是本人”。两者串在同一次流程里，客户拿到的是一条完整的人证核验记录：先读证确认证件有效，再比对人脸确认持证人一致，结果一次返回、一次留档。

只做读证也够用的场景同样存在，比如登记、开卡、收寄、访客放行——这些场景要的是“信息准、有记录”，不一定要求确认持证人。

产品规格与交付

下表以现有接口能力为基准整理。标注“待确认”的参数，请按最终签约通道的承诺填写，未确认前不要对外报价或承诺可用性指标。

交付内容包含：SDK 与集成说明、接口文档、测试账号与联调支持、错误码与对账口径说明。

接入流程

从开通到上线是四步，客户侧的开发量集中在第二、三步。

1. **开通与建应用。**在平台创建应用，取得 appId 与 appKey，并按端登记包名或 bundleId。

2. **集成 SDK。**在 Android 或 iOS 端接入，初始化阶段完成应用鉴权，拿到 token。

3. **联调。**在测试环境打通“取 token → 校验次数 → 读卡上送 → 接收 SDK 回调”的完整链路，把回调处理、超时与重试策略定下来。

4. **上线与对账。**生产环境开通可用次数，按 requestId 与计费条数做日对账。

返回字段基本可以直接填进现有的登记表或受理单，需要改动的通常只是取数字段和一处读卡入口，不涉及数据库结构调整。

合规与安全

身份证信息属于敏感个人信息。平台侧完成鉴权、解码与计次，合规动作仍然要客户在自己的业务里完成，两边分工如下。

涉及经营资质与数据授权范围的对外承诺，以签约主体提供的资质文件为准，本介绍不作扩展解释。

常见问题

手机没有 NFC，还能用吗？ 不能，读卡依赖手机自带 NFC 硬件。建议接入前按机型核对支持范围，对无 NFC 的设备保留 OCR 作为兜底，两条链路共用同一套结果字段。

用户不愿意贴证怎么办？ 这属于流程设计问题。现场把“贴一下”和“填一张表”放在一起对比，接受度通常更高；也可以让 OCR 与读证并存，由用户选择。

拍照 OCR 已经很便宜，为什么还要换？ OCR 处理的是证件表面图像，反光、磨损、字体差异都会转成错录，错录的返工成本最终落在人工上。芯片读取不依赖成像条件，还能顺带验证证件本身，两类成本的性质不同。

SDK 回调拿到的结果能直接展示吗？ 建议拿到回调后先完成比对与落库，界面上只展示业务必需的字段；完整明文不留在前端，也不写进日志。

一张证件能反复读吗？ 技术上可以。业务上建议按“一次业务一次核验”控制，避免同一笔业务重复调用。

能不能识别伪造证件？ 芯片无法正常响应或解不出合法数据，通常说明证件有问题。但读证不能替代人证比对，确认“是不是本人”仍需要人脸环节。