架构与系统设计 / 系统课时
商户入驻流程
商户入驻流程
商户入驻不是一次“新增商户”操作,而是一组受状态约束的业务动作。本课将把申请、审核、启用、停用和注销串成可落地的生命周期,并给出状态校验、审计留痕和验收方法。
学习目标
- 识别商户生命周期中的状态与合法转换
- 设计申请资料、审核记录和商户主体之间的职责边界
- 通过状态校验避免越权启用、重复审核和错误注销
明确生命周期和状态边界
建议把商户状态定义为 DRAFT、PENDING_REVIEW、REJECTED、ENABLED、DISABLED 和 CANCELLED。状态变化必须由明确动作触发,不能允许后台直接修改状态字段。

DRAFT 表示资料尚未提交;PENDING_REVIEW 表示资料已冻结并等待审核;REJECTED 允许补充资料后重新提交;ENABLED 才能创建交易;DISABLED 暂停业务但保留历史数据;CANCELLED 为不可恢复的终态。
用状态机约束业务操作
下面的完整 Java 示例集中声明合法转换,业务服务只调用 canTransition 判断,不把规则散落在多个控制器中。
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));
}
}预期输出:
true
false在真实服务中,状态更新还要带上旧状态作为条件,例如执行“审核通过”时使用 WHERE id = ? AND status = 'PENDING_REVIEW'。受影响行数为 0 时,应返回“状态已变化”,而不是覆盖其他操作人的结果。
组织申请、审核与启停流程
申请资料与正式商户主体应分开保存。申请记录承载联系人、营业执照、结算账户和提交版本;商户主体只保存审核通过后可用于交易的稳定信息。审核记录则单独保存审核人、结论、意见和时间,保证每次决策都可追溯。
提交审核时先校验必填资料,再生成不可变的资料快照并进入 PENDING_REVIEW。审核通过后,在同一事务中创建或更新商户主体、写入审核记录并切换到 ENABLED;审核驳回只记录原因,不直接删除申请。
停用用于风险控制、欠费或合规暂停,不能清除订单和结算数据。注销前应确认不存在处理中交易、未完成退款和待结算资金;注销成功后拒绝重新启用,并保留历史记录供审计查询。
验收关键场景
至少验证四类场景:重复提交审核只能成功一次;非审核角色不能执行通过或驳回;停用商户的新交易被拒绝但历史订单仍可查询;存在未结算资金时注销失败。所有状态变更都应记录操作人、来源、原因和时间。
Tips:资料修改与状态修改应使用不同接口。这样既能限制审核中的资料被篡改,也能让权限规则保持清晰。