门店授权这一步经常被当成「走个流程」,结果上线后才发现:新开的店没授权,所有核销全失败;授权悄悄过期,早上还好好的下午就报错。

一、授权到底在确认什么

本质是一句话:商家用自己的平台账号,确认「允许这个系统替我核销这家店的券」。产出的是一份门店级凭据。

  • 粒度是门店 × 平台,不是账号级。10 家店 × 2 个平台 = 20 份授权
  • 必须由商家自己在平台侧确认,你无法代替
  • 凭据可被商家解除,也可因长期不用或其他规则失效
  • 凭据能做什么受平台规则约束,不是万能钥匙

二、标准流程

  1. 在你的后台为每个门店生成授权入口(通常是一个二维码或跳转链接)
  2. 门店负责人用平台商家账号扫码 / 点击,进入平台授权页
  3. 在平台侧勾选要授权的内容并确认
  4. 平台回调或前端回跳,你把拿到的门店凭据存到服务端
  5. 调一次只读接口验证凭据真的可用(不要假设拿到就是有效)
  6. 在后台展示授权状态与到期时间,供运营查看

第 5 步经常被省掉。结果是「状态显示已授权,核销时报授权无效」—— 因为拿到凭据和凭据可用是两件事。

三、凭据该怎么存

要点错误做法正确做法
存储位置存在内存或 Session 里持久化到数据库/缓存,按门店索引
键的设计只按门店ID 存按「平台 + 门店」组合键,预留主体维度
类型按数值存储按字符串存储,避免精度与类型问题
状态维护只存凭据本身同时存授权时间、到期时间、最近验证时间
多实例每个实例各自授权统一存共享存储,所有实例读同一份

四、五种典型失败

现象原因处理
授权页打不开或提示无权操作商家账号未绑定该门店,或不是门店管理员让商家先在平台侧确认账号与门店的绑定关系
授权成功但核销报无效拿到凭据后未验证;或凭据已被解除调只读接口验证;展示状态供运营巡检
某天开始全部报授权失效凭据过期,或商家在后台解除了授权识别该错误类型并引导重新授权,不要当成业务错
部分门店正常、部分不正常这些店根本没做过授权上线前把「未授权门店」做成强制校验
换实例后需要重新授权凭据存在本地内存改为共享存储

五、把授权状态做成可运营的

技术上能调通还不够 —— 运营要能自己发现哪家店没授权。建议在后台提供:

  • 门店列表 + 各平台授权状态(已授权 / 待授权 / 已失效)
  • 到期时间与「即将到期」提醒
  • 一键生成授权二维码,可直接发给门店负责人
  • 批量巡检:定期对已授权门店做一次只读验证,失效的标红

巡检这一步能避免「等到顾客核销失败才发现授权没了」。

六、用聚合接口时的授权

云飞API 把四个平台(美团、大众点评、抖音、快手)的授权入口统一成一个流程,差异是:

  • 同一家门店在后台一次配置,各平台授权状态分别展示
  • 授权失效时返回明确的错误语义,可与业务错误区分处理
  • 凭据由服务方托管,你的系统不需要保存平台原始凭据
  • 门店映射表用本地门店ID 作主键,平台标识分字段存放

常见问题

一个门店授权后,能核所有平台的券吗?

不能。授权是按平台做的,美团券要美团授权,抖音券要抖音授权。

连锁品牌有几十家店,必须一家家授权吗?

授权粒度是门店级的,通常需要逐店完成。批量授权能力取决于平台是否提供,接入前应确认你的门店结构是否与之匹配。

店员离职会影响授权吗?

取决于当时用谁的账号完成授权。若用个人账号且该账号权限被收回,授权可能失效。建议用门店级管理员账号,并在人员变动后巡检一次。