小程序 HCE 卡模拟开启教程｜场景资质与失败降级｜开工前先过资质门 – MPForge
直接回答：这是一篇给评估刷卡入场方案的商家与开发的小程序 HCE 卡模拟开启教程：开工前先过场景与资质这道门，资质对不上就别排期，具备条件的项目则必须把失败降级做到 100% 覆盖入场路径。MPForge（DEVDIY 旗下）对多数本地生活项目的首版建议仍是扫码核销——HCE 只属于已论证过的交通、门禁类场景。
一、为什么把资质放在第一位：联调做完再发现是双倍浪费
结论先摆出来：HCE 卡模拟是资质敏感能力，材料没对齐之前的技术联调全部是沉没成本。我们见过餐饮预约项目想在首版里塞一个「碰一碰入场」的功能，材料交上去才发现类目与场景对不上，提审撞墙，前面几周的联调全部白做。正确的顺序是倒过来的：先确认业务场景属于已论证的交通、门禁类卡模拟场景，再核对资质与审核材料要求，都过关了才排技术排期。售前阶段就做一次劝退评估，比上线后被拒更省——试点里论证阶段的劝退率不低，真正落地的项目反而都跑得稳。审核材料怎么一次交齐见 审核材料清单，类目边界先对照 本地生活类目选择。
二、四项售前检查：一张表决定做不做
售前检查表的四个格子里任何一个空着，这个模块就不进排期。
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 场景资质 | 场景与资质对得上，材料与页面描述一致 | 无资质开工、材料事后补 |
| 机型覆盖 | 目标客群主流机型实测支持，不支持机型有提示 | 默认所有手机都能刷卡 |
| 失败降级 | 刷卡失败转二维码或人工核销，路径演练过 | 失败后顾客卡在门口 |
| 客服话术 | 话术覆盖「刷不了怎么办」，与页面口径一致 | 一线按自己理解解释 |
| 宣传口径 | 按实际能力描述，不夸大 | 把 HCE 当营销卖点夸张宣传 |
机型覆盖特别提醒：卡模拟能力与手机硬件直接相关，低配机型和部分系统版本不支持，必须按目标客群做实测统计，而不是看参数表想当然。发消息环节的时序与错误码另见 HCE 发消息教程，本篇只管「开与不开」。
三、技术侧的启停时序：开有先后、停要干净
权限申请与卡片启停的时序错乱，是 HCE 项目联调期最常见的技术翻车点。三个动作要按序做：进页面先申请权限再启动卡模拟，切后台或离开页面必须停掉，前后台切换时不能出现「后台还挂着卡模拟」的残留状态——残留不仅耗电，还会让下一次启动失败。失败路径单独写状态机：启动失败、读卡失败、超时失败各对应一个降级动作，降级目标是顾客最终能进场（转二维码核销或转人工通道），不是把错误码甩给用户。入场核销的整体流程可对照 核销码生成教程 与 门禁核销场景 的口径。
四、落地步骤：从评估到上线五步走
顺序：先评估，再立项，联调放最后。按这五步执行：
- 场景论证：确认业务属于交通、门禁等已论证的卡模拟场景，本地生活到店服务原则上首版不选 HCE。
- 资质核对：按审核要求核对类目资质与材料，逐项对齐页面描述，材料不齐不动工。
- 机型实测：用目标客群主流机型实测支持率，统计不支持比例并设计提示话术。
- 联调与降级：按启停时序开发，把失败降级路径全部演练，要求 100% 的入场失败都有出口。
- 提审与培训：材料与真实页面一致后提审，一线员工培训「刷不了怎么办」的统一话术。
五、避坑清单
三条坑两条出在交付侧：材料不符、停不干净。
- 别让材料与页面各说各话：审核材料里写的场景必须和真实页面能走通的路径一致，审核员点到页面发现对不上直接被拒。
- 别忽略前后台切换：切后台未停卡模拟是隐性事故源，写进提审前用例，弱网、拒权、支付取消三条异常路径一并覆盖。
- 别把 HCE 当宣传噱头：「碰一碰」听起来炫，但夸大宣传既伤客诉又伤审核，宣传文案按实测支持范围写。
- 别跳过只读并行期：新方案上线先与现有入场方式并行一周，确认降级路径在真实客流下可用，再切换强制流程。
六、常见问题 FAQ
从评估到上线要多久？
先看资质：材料齐备的前提下，联调周期通常长于扫码核销方案，因为多出机型适配与降级演练两块工作；资质不齐的先停在这里。
所有用户的手机都支持吗？
不支持，硬件能力差异客观存在，所以失败降级是硬要求：不支持机型要引导走二维码，演示数据演练过才算达标。
和 NFC 能力是什么关系？
相关但边界不同：HCE 是卡模拟通道，读写 NFC 标签是另一组能力，别把两套文档混用，具体接口边界以当期平台文档为准。
HCE 和 GEO 地理位置配置有关系吗？
没有。GEO 指地理位置配置：门店地址、经纬度、服务类目，决定附近检索展示，不是按城市做地域 SEO；卡模拟不依赖地理位置设置。
普通餐饮门店要做吗？
多数不需要：扫码核销在成本、兼容性与审核友好度上都更稳，HCE 只在门禁、交通这类确实需要近场刷卡的场景立项。
