门店授权这一步经常被当成「走个流程」,结果上线后才发现:新开的店没授权,所有核销全失败;授权悄悄过期,早上还好好的下午就报错。
一、授权到底在确认什么
本质是一句话:商家用自己的平台账号,确认「允许这个系统替我核销这家店的券」。产出的是一份门店级凭据。
- 粒度是门店 × 平台,不是账号级。10 家店 × 2 个平台 = 20 份授权
- 必须由商家自己在平台侧确认,你无法代替
- 凭据可被商家解除,也可因长期不用或其他规则失效
- 凭据能做什么受平台规则约束,不是万能钥匙
二、标准流程
- 在你的后台为每个门店生成授权入口(通常是一个二维码或跳转链接)
- 门店负责人用平台商家账号扫码 / 点击,进入平台授权页
- 在平台侧勾选要授权的内容并确认
- 平台回调或前端回跳,你把拿到的门店凭据存到服务端
- 调一次只读接口验证凭据真的可用(不要假设拿到就是有效)
- 在后台展示授权状态与到期时间,供运营查看
第 5 步经常被省掉。结果是「状态显示已授权,核销时报授权无效」—— 因为拿到凭据和凭据可用是两件事。
三、凭据该怎么存
| 要点 | 错误做法 | 正确做法 |
|---|---|---|
| 存储位置 | 存在内存或 Session 里 | 持久化到数据库/缓存,按门店索引 |
| 键的设计 | 只按门店ID 存 | 按「平台 + 门店」组合键,预留主体维度 |
| 类型 | 按数值存储 | 按字符串存储,避免精度与类型问题 |
| 状态维护 | 只存凭据本身 | 同时存授权时间、到期时间、最近验证时间 |
| 多实例 | 每个实例各自授权 | 统一存共享存储,所有实例读同一份 |
四、五种典型失败
| 现象 | 原因 | 处理 |
|---|---|---|
| 授权页打不开或提示无权操作 | 商家账号未绑定该门店,或不是门店管理员 | 让商家先在平台侧确认账号与门店的绑定关系 |
| 授权成功但核销报无效 | 拿到凭据后未验证;或凭据已被解除 | 调只读接口验证;展示状态供运营巡检 |
| 某天开始全部报授权失效 | 凭据过期,或商家在后台解除了授权 | 识别该错误类型并引导重新授权,不要当成业务错 |
| 部分门店正常、部分不正常 | 这些店根本没做过授权 | 上线前把「未授权门店」做成强制校验 |
| 换实例后需要重新授权 | 凭据存在本地内存 | 改为共享存储 |
五、把授权状态做成可运营的
技术上能调通还不够 —— 运营要能自己发现哪家店没授权。建议在后台提供:
- 门店列表 + 各平台授权状态(已授权 / 待授权 / 已失效)
- 到期时间与「即将到期」提醒
- 一键生成授权二维码,可直接发给门店负责人
- 批量巡检:定期对已授权门店做一次只读验证,失效的标红
巡检这一步能避免「等到顾客核销失败才发现授权没了」。
六、用聚合接口时的授权
云飞API 把四个平台(美团、大众点评、抖音、快手)的授权入口统一成一个流程,差异是:
- 同一家门店在后台一次配置,各平台授权状态分别展示
- 授权失效时返回明确的错误语义,可与业务错误区分处理
- 凭据由服务方托管,你的系统不需要保存平台原始凭据
- 门店映射表用本地门店ID 作主键,平台标识分字段存放
常见问题
一个门店授权后,能核所有平台的券吗?
不能。授权是按平台做的,美团券要美团授权,抖音券要抖音授权。
连锁品牌有几十家店,必须一家家授权吗?
授权粒度是门店级的,通常需要逐店完成。批量授权能力取决于平台是否提供,接入前应确认你的门店结构是否与之匹配。
店员离职会影响授权吗?
取决于当时用谁的账号完成授权。若用个人账号且该账号权限被收回,授权可能失效。建议用门店级管理员账号,并在人员变动后巡检一次。