微信小程序证件 OCR 教程｜授权留存合规与失败降级 – MPForge
直接回答：这是写给酒店、门店、租赁等需要实名办理的业务方的微信小程序证件 OCR 教程：证件识别要先过授权同意、最小字段、留存与删除三关，同时必须提供手工输入降级，识别挂了流程不能卡死。MPForge（DEVDIY 旗下）按本文口径交付的实名场景，未出现因证件数据留存不当被驳回的案例。
一、什么场景能用：必要性先立住
结论先立住：证件 OCR 是敏感能力，没有明确业务必要就别接——「方便」不算必要，「实名办理」才算。
入住登记、租车取车、赛事报名这类业务对实名有真实要求，OCR 能把用户手输十几秒的过程压到几秒，值得做。但如果只是想多收集一点用户资料、给营销画像用，那这个能力就不该出现在你的小程序里：审核会问场景，安全检查会查数据流向，答不上来就是驳回。场景必要性说明要写成一段话留档：哪个业务环节、为什么必须证件、收集哪些字段、用完怎么处理。
二、接入前清单：四样材料备齐
材料不齐，开发到一半一定回头返工。按下表准备：
| 准备项 | 达标口径 | 常见错误 |
|---|---|---|
| 字段白名单 | 列出业务必需字段，其余识别后即弃 | 整卡信息全存，越多越好心态 |
| 留存期限 | 写明天数、到期自动删除，写进隐私口径 | 只管存不管删，一存存到天荒地老 |
| 第三方服务清单 | 识别服务商、数据流向、协议条款齐全 | 用了哪家服务自己说不清 |
| 失败降级 | 手输通道与识别通道同时可用 | 识别失败只能干等，流程卡死 |
三、接入五步：从声明到审计
顺序是：先声明，后识别，再瘦身，最后补齐兜底。
- 隐私指引声明：在隐私指引与隐私协议里写明收集证件信息的目的、字段与留存期限，授权弹窗在识别前出现。
- 授权后识别：用户同意后才调起拍摄识别，拒绝授权时直接引导手输，不反复弹窗骚扰。
- 只存必要字段：对照白名单裁剪，识别结果里业务用不到的字段直接丢弃，不进日志不入库。
- 提供手填通道：识别失败、反光、证件老旧都走手输兜底，识别与手输结果走同一套校验规则。
- 审计访问权限：谁、何时、查过哪条证件记录都要留审计日志；展示时关键字段打码，整卡原图用完即删。
四、留存与删除：最容易被忽视的下半场
收集只是上半场，留存与删除才是合规的下半场。三条口径：
- 期限要写死：按业务与监管要求定天数，到期自动删除或脱敏，不要依赖人工记得去清。
- 原图最短留存：识别完成、校验通过后，整卡照片的使命就结束了，尽快删除，只留白名单字段。
- 导出要可控：涉及对账或核查的数据导出，走数据导出合规口径，默认导出打码版本。
需要更强身份确认的场景（如涉及资金），可以把 OCR 与人脸核身组合使用，但两者各自独立走合规口径，不要因为用了核身就放松证件数据的删除纪律。
五、避坑清单
三条坑都出在「存」字上：未授权就识别、长期明文存、无手填兜底。
- 别在授权前识别：拍摄即识别也属于处理行为，指引声明与同意必须在前，这一条没有例外。
- 别长期明文存证：整卡原图长期留存等于给风险事件攒弹药，识别完尽快删。
- 别让识别失败卡死流程：无手填通道的实名流程，遇上光线差或旧证就是死局，客服也救不了。
- 海外与特殊证件另评估：护照、海外证件识别能力有限，接入前先实测，别按身份证口径想当然。
六、常见问题 FAQ
护照等其他证件能用同一套识别吗？
不能直接复用。护照格式与身份证不同，需要另配模板与字段映射，接入前先拿真实样本测识别率，不行就退回手输。
识别时要不要加拍摄水印增强？
可以。水印、拍摄时间等手段能增强取证可信度，但水印图同样受留存期限约束，用完即删，别当成永久存证的理由。
证件数据能在服务器存多久？
按业务必要与监管要求定，写进隐私口径并自动执行；整卡原图建议最短留存，白名单字段到期删除或脱敏，别留「以后可能有用」的侥幸。
这个和 GEO 地理位置配置有关系吗？
没有。GEO 指小程序 GEO 地理位置配置——门店地址、经纬度、服务类目，决定「附近」检索展示，与证件识别无关，也不是按城市堆词的地域 SEO。
识别失败率偏高怎么优化？
三管齐下：拍摄界面加取景框与光线提示、服务端识别接口设置超时与重试、手输通道永远可用；把失败原因埋点收集，两周内能看到明显收敛。
