架构与系统设计 / 系统课时

商户入驻流程

商户入驻流程

商户入驻不是一次“新增商户”操作,而是一组受状态约束的业务动作。本课将把申请、审核、启用、停用和注销串成可落地的生命周期,并给出状态校验、审计留痕和验收方法。

学习目标

  • 识别商户生命周期中的状态与合法转换
  • 设计申请资料、审核记录和商户主体之间的职责边界
  • 通过状态校验避免越权启用、重复审核和错误注销

明确生命周期和状态边界

建议把商户状态定义为 DRAFT、PENDING_REVIEW、REJECTED、ENABLED、DISABLED 和 CANCELLED。状态变化必须由明确动作触发,不能允许后台直接修改状态字段。

商户入驻生命周期状态图

DRAFT 表示资料尚未提交;PENDING_REVIEW 表示资料已冻结并等待审核;REJECTED 允许补充资料后重新提交;ENABLED 才能创建交易;DISABLED 暂停业务但保留历史数据;CANCELLED 为不可恢复的终态。

用状态机约束业务操作

下面的完整 Java 示例集中声明合法转换,业务服务只调用 canTransition 判断,不把规则散落在多个控制器中。

java
import java.util.EnumSet;
import java.util.Map;

public class MerchantLifecycleDemo {
    enum Status {
        DRAFT, PENDING_REVIEW, REJECTED, ENABLED, DISABLED, CANCELLED
    }

    private static final Map<Status, EnumSet<Status>> ALLOWED = Map.of(
        Status.DRAFT, EnumSet.of(Status.PENDING_REVIEW, Status.CANCELLED),
        Status.PENDING_REVIEW, EnumSet.of(Status.ENABLED, Status.REJECTED, Status.CANCELLED),
        Status.REJECTED, EnumSet.of(Status.DRAFT, Status.CANCELLED),
        Status.ENABLED, EnumSet.of(Status.DISABLED),
        Status.DISABLED, EnumSet.of(Status.ENABLED, Status.CANCELLED),
        Status.CANCELLED, EnumSet.noneOf(Status.class)
    );

    static boolean canTransition(Status from, Status to) {
        return ALLOWED.getOrDefault(from, EnumSet.noneOf(Status.class)).contains(to);
    }

    public static void main(String[] args) {
        System.out.println(canTransition(Status.PENDING_REVIEW, Status.ENABLED));
        System.out.println(canTransition(Status.CANCELLED, Status.ENABLED));
    }
}

预期输出:

text
true
false

在真实服务中,状态更新还要带上旧状态作为条件,例如执行“审核通过”时使用 WHERE id = ? AND status = 'PENDING_REVIEW'。受影响行数为 0 时,应返回“状态已变化”,而不是覆盖其他操作人的结果。

组织申请、审核与启停流程

申请资料与正式商户主体应分开保存。申请记录承载联系人、营业执照、结算账户和提交版本;商户主体只保存审核通过后可用于交易的稳定信息。审核记录则单独保存审核人、结论、意见和时间,保证每次决策都可追溯。

提交审核时先校验必填资料,再生成不可变的资料快照并进入 PENDING_REVIEW。审核通过后,在同一事务中创建或更新商户主体、写入审核记录并切换到 ENABLED;审核驳回只记录原因,不直接删除申请。

停用用于风险控制、欠费或合规暂停,不能清除订单和结算数据。注销前应确认不存在处理中交易、未完成退款和待结算资金;注销成功后拒绝重新启用,并保留历史记录供审计查询。

验收关键场景

至少验证四类场景:重复提交审核只能成功一次;非审核角色不能执行通过或驳回;停用商户的新交易被拒绝但历史订单仍可查询;存在未结算资金时注销失败。所有状态变更都应记录操作人、来源、原因和时间。

Tips:资料修改与状态修改应使用不同接口。这样既能限制审核中的资料被篡改,也能让权限规则保持清晰。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

商户入驻流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通