给单个商户做核销,写通就行;给几百家商户做,第一个月能跑,第三个月会开始出问题 —— 因为授权、映射、计费这三件事没有按多租户设计。

一、授权:谁能代表商户操作

核销授权必须由商户自己完成。SaaS 的角色是「提供入口 + 托管结果」:

  • 每个商户、每个门店生成独立的授权入口
  • 授权完成后凭据归该商户,不能跨商户复用
  • 商户可以随时解除授权,系统要能感知并停用该店
  • 代运营场景下要小心:运营人员不应持有商户凭据的原始值
  • 凭据存储要加密,且与商户ID 强绑定,避免拼错导致跨商户调用

二、门店映射表怎么设计

这是多租户场景的核心表。建议结构:

字段说明
商户ID租户主键,所有查询必须带
本地门店ID商户自己系统里的门店标识
平台美团 / 点评 / 抖音 / 快手
平台门店ID按平台填,字符串存储
授权状态未授权 / 已授权 / 已失效
授权时间、到期时间用于巡检与提醒
最近验证时间判断凭据是否真的可用
  • 唯一索引建在「商户ID + 平台 + 本地门店ID」上
  • 平台门店ID 允许为空(该店没上这个平台),但核销前必须校验非空
  • 映射表要能由运营自己维护,不要写死在配置里
  • 变更要留历史,便于回溯「某天的核销为什么到了另一个店」

三、开通流程怎么设计

  1. 商户入驻,创建租户
  2. 录入门店,生成门店映射(平台门店ID 待填)
  3. 生成各平台的授权二维码,交给商户
  4. 商户扫码授权,系统回写授权状态
  5. 调只读接口验证凭据可用
  6. 在该店跑一笔真实券的验券准备,确认能查到券
  7. 开通完成,进入可核销状态

第 6 步是关键验证。很多开通流程做完前五步就宣告完成,结果商户第一笔真实核销就失败 —— 因为映射填错或授权其实无效。

四、计费与账单怎么分

按核销成功次数计费的模式下,账单要能按商户拆开:

  • 每笔核销记录商户ID、门店ID、平台、券类型
  • 月度账单按商户汇总,商户能自己看到明细
  • 预核销与正式核销分开记,避免把不计费的算进账单
  • 有免费额度或试用期时,扣减规则要写进账单说明

五、四个容易出事的边界

边界风险处理
商户解除授权该店核销全部失败,但系统仍显示正常授权状态巡检 + 失败时明确提示重新授权
商户退租凭据与数据如何处理停用授权、导出核销流水、按合规要求清理
门店改绑平台门店历史核销记录关联错乱变更留历史,核销记录存变更时的映射快照
员工离职带走账号授权可能随之失效用商户级管理员账号授权,人员变动后巡检

六、用聚合接口时的多租户

云飞API 支持 SaaS 场景,多租户接入时需要确认的做法:

  • 一个服务端账号下管理多个商户,凭据与数据按商户隔离
  • 门店映射由 SaaS 侧维护,平台差异由接口层消化
  • 核销流水可按商户+门店+平台查询,便于生成商户账单
  • 美团、点评、抖音、快手在同一套模型下,接入新平台不改业务代码

常见问题

一套系统能给不同商户用同一套代码吗?

可以,前提是商户维度贯穿授权、映射、计费三处。漏掉任何一处都会串数据。

商户自己也能看到核销数据吗?

建议提供商户侧视图,至少能看到本店的核销流水与账单。这能显著降低客服压力。