给单个商户做核销,写通就行;给几百家商户做,第一个月能跑,第三个月会开始出问题 —— 因为授权、映射、计费这三件事没有按多租户设计。
一、授权:谁能代表商户操作
核销授权必须由商户自己完成。SaaS 的角色是「提供入口 + 托管结果」:
- 每个商户、每个门店生成独立的授权入口
- 授权完成后凭据归该商户,不能跨商户复用
- 商户可以随时解除授权,系统要能感知并停用该店
- 代运营场景下要小心:运营人员不应持有商户凭据的原始值
- 凭据存储要加密,且与商户ID 强绑定,避免拼错导致跨商户调用
二、门店映射表怎么设计
这是多租户场景的核心表。建议结构:
| 字段 | 说明 |
|---|---|
| 商户ID | 租户主键,所有查询必须带 |
| 本地门店ID | 商户自己系统里的门店标识 |
| 平台 | 美团 / 点评 / 抖音 / 快手 |
| 平台门店ID | 按平台填,字符串存储 |
| 授权状态 | 未授权 / 已授权 / 已失效 |
| 授权时间、到期时间 | 用于巡检与提醒 |
| 最近验证时间 | 判断凭据是否真的可用 |
- 唯一索引建在「商户ID + 平台 + 本地门店ID」上
- 平台门店ID 允许为空(该店没上这个平台),但核销前必须校验非空
- 映射表要能由运营自己维护,不要写死在配置里
- 变更要留历史,便于回溯「某天的核销为什么到了另一个店」
三、开通流程怎么设计
- 商户入驻,创建租户
- 录入门店,生成门店映射(平台门店ID 待填)
- 生成各平台的授权二维码,交给商户
- 商户扫码授权,系统回写授权状态
- 调只读接口验证凭据可用
- 在该店跑一笔真实券的验券准备,确认能查到券
- 开通完成,进入可核销状态
第 6 步是关键验证。很多开通流程做完前五步就宣告完成,结果商户第一笔真实核销就失败 —— 因为映射填错或授权其实无效。
四、计费与账单怎么分
按核销成功次数计费的模式下,账单要能按商户拆开:
- 每笔核销记录商户ID、门店ID、平台、券类型
- 月度账单按商户汇总,商户能自己看到明细
- 预核销与正式核销分开记,避免把不计费的算进账单
- 有免费额度或试用期时,扣减规则要写进账单说明
五、四个容易出事的边界
| 边界 | 风险 | 处理 |
|---|---|---|
| 商户解除授权 | 该店核销全部失败,但系统仍显示正常 | 授权状态巡检 + 失败时明确提示重新授权 |
| 商户退租 | 凭据与数据如何处理 | 停用授权、导出核销流水、按合规要求清理 |
| 门店改绑平台门店 | 历史核销记录关联错乱 | 变更留历史,核销记录存变更时的映射快照 |
| 员工离职带走账号 | 授权可能随之失效 | 用商户级管理员账号授权,人员变动后巡检 |
六、用聚合接口时的多租户
云飞API 支持 SaaS 场景,多租户接入时需要确认的做法:
- 一个服务端账号下管理多个商户,凭据与数据按商户隔离
- 门店映射由 SaaS 侧维护,平台差异由接口层消化
- 核销流水可按商户+门店+平台查询,便于生成商户账单
- 美团、点评、抖音、快手在同一套模型下,接入新平台不改业务代码
常见问题
一套系统能给不同商户用同一套代码吗?
可以,前提是商户维度贯穿授权、映射、计费三处。漏掉任何一处都会串数据。
商户自己也能看到核销数据吗?
建议提供商户侧视图,至少能看到本店的核销流水与账单。这能显著降低客服压力。