小程序到店核销场景教程｜券码、定位与人工降级实务 – MPForge
直接回答：到店核销的翻车点很集中：码失效、弱网扫不动、出问题时没有人工降级。本文把到店核销场景拆成码、定位、降级、对账四块，给商家与开发一套实务口径：码怎么生成与刷新、定位校验怎么设成可选项、断网时前台怎么办、核销流水怎么对账。MPForge（DEVDIY 旗下）按这套口径上线的门店，核销环节的现场客诉基本归零，月底账实差异逐月收敛。
一、码：核销凭证怎么生成与失效
结论：核销码的安全等级取决于业务风险——静态码方便但可转发，动态码安全但要处理刷新与弱网。
两类码混用是事故源头。团购券、预约凭证用一次性动态码，会员权益码可以适度放宽。生成与失效口径：
- 生成规则：码与订单实例一一绑定，包含订单号、有效期、核销次数上限，生成细节见 核销码生成。
- 动态刷新：高风险券用 60 秒刷新的动态码，截图转发出去也用不了；刷新失败时保留上一码的有效缓冲，别让用户在柜台前对着转圈的白屏。
- 失效边界：已核销、已退款、超过有效期的码一律拒绝，拒绝时明确告诉用户原因，不给前台「要不要通融」的空间。
防截图、防转发的完整策略，见 核销码安全。
二、定位校验：有用，但必须是可选项
结论：定位校验用于防「远程冒核」，不能做成硬门槛——拒权、室内误差都会把正常用户挡在门外。
有的业务要求「人必须在店」才能核销，比如到店体验、团购套餐。这类场景加定位校验有价值，但口径要放宽：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 校验方式 | 用户端上报位置与门店坐标偏差 500 米内即放行 | 要求精确定位，室内误差直接卡死 |
| 拒权处理 | 拒权不阻断核销，标记「未校验」给前台二次确认 | 拒权直接报错，用户当场流失 |
| 提示时机 | 核销前一次性说明用途，写进隐私口径 | 反复索权，触发系统限制 |
| 数据留存 | 定位结果只存是否通过，不存轨迹 | 存原始轨迹，隐私与存储双风险 |
门店坐标怎么配准、误差怎么校，与小程序 GEO 地理位置配置直接相关：地址、经纬度、服务类目配准后，定位校验才有基准点——注意这是地理位置配置，不是按城市做地域 SEO。
三、人工降级：现场必须有第二条路
结论：核销系统的可靠性以「断网也能完成接待」为标准——人工降级是流程的一部分，不是临时救火。
- 降级触发：扫码连续失败、系统超时或断网超过一分钟，前台启动人工流程，不等用户提意见。
- 人工登记：按订单号或手机号后四位核对身份，纸质或本地表单记录券号、时间、操作员。
- 当日回写：网络恢复后 当天内把人工核销补录进系统，补录人签字确认，过时锁定防止事后补改。
- 权限分离：谁登记、谁补录、谁审核分开设权限，权限模型见 多门店权限模型，避免「登记补录一人全包」。
- 事后对账：人工核销与系统核销在流水里同一张表展示，差异行单独列出，口径见 核销流水不可篡改。
四、对账：核销不是扫完就结束
结论：核销数据要对得上三个口径——用户看到的、前台操作的和财务账上的必须一致。
- 用户侧：核销成功后券状态当场变更并推送确认，别让用户下次到店才发现券已被用。
- 门店侧：每班次交接时核对当班核销笔数与登记表，交接差异当场查清。
- 财务侧：核销流水与结算单按订单号对齐，退款冲减单独列示，参考 优惠券核销对账。
- 跨店互斥：连锁多店共享券池时，核销要做互斥，杜绝同一券在两家店同时通过的脏数据，见 跨店核销互斥。
五、避坑清单
这三条坑都在「没想到现场会出意外」。
- 别假设网络永远在线：地下室、电梯口的门店弱网是常态，降级流程不演练，第一次断网就是客诉现场。
- 别让权限混乱：「人人都能补录」等于没有对账——登记、补录、审核三权分立，离职与轮班当天就调权限。
- 别把定位做成硬门槛：定位只做风控参考，硬拒绝正常用户造成的损失，远大于偶尔一次冒核。
- 别用体验码做核销验收：上线前用真实订单全流程走一遍，包括退款券、过期券、降级补录，测试环境的数据不进生产账。
六、常见问题 FAQ
用户手机没电或码刷不出来怎么办？
人工降级流程兜底：凭订单号或手机号核对身份后手工登记核销，网络恢复后当天补录。这是标准流程，不算「违规操作」，但登记与补录要分开权限。
定位校验会不会影响核销速度？
上报位置在后台并行进行，不阻塞扫码动作；偏差在阈值内直接通过。整体增加的等待在一秒以内，用户基本无感。
动态码用户嫌刷新麻烦怎么办？
把刷新做在页面里自动进行，用户只出示不操作；同时保留刷新失败时的缓冲期。安全性要求不高的会员码，可退回静态码加次数限制。
这个场景和 GEO 地理位置配置有关系吗？
有。定位校验的基准点是小程序 GEO 地理位置配置里的门店经纬度——地址、经纬度、服务类目配准后，偏差计算才有意义。它是地理位置配置，不是按城市做地域 SEO，别在文案里堆地名。
核销差错怎么追溯？
每笔核销记录操作员、时间、设备与来源（扫码或补录），流水不可篡改只可冲正。差错按订单号定位到人，复盘看的是流程漏洞，不先追个人责任。
