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

支付方式标准化

支付方式标准化

本课解决支付平台中“同一种付款能力被不同系统用不同名称表达”的问题。完成后,你将建立统一的支付方式、产品类型与渠道交易类型模型,并用一处映射代码隔离渠道差异。

学习目标

  • 区分支付方式、产品类型和渠道交易类型的职责
  • 设计稳定的标准枚举与渠道映射关系
  • 通过可运行示例验证映射结果与异常边界

三层模型分别解决什么问题

支付方式描述用户“怎么付”,例如银行卡、电子钱包或二维码;产品类型描述平台“卖给商户什么能力”,例如银行卡收单、钱包支付;渠道交易类型则是下游通道真正接收的协议值。三者不能混为一个枚举,否则新增通道时会不断污染平台模型。

层级 面向对象 示例 稳定性
支付方式 商户与前端 CARD、WALLET、QR_CODE 较稳定
产品类型 平台业务 CARD_PAYMENT、WALLET_PAYMENT 稳定
渠道交易类型 外部通道 SALE、WX_NATIVE、ALI_QR 随渠道变化

支付方式标准化三层映射关系

映射规则与 Java 实现

推荐让业务请求先归一化为平台产品,再由“渠道适配器”把平台产品转换成对应渠道交易类型。映射只允许单向依赖:业务层可以认识平台标准,平台标准不能反向依赖某个渠道的枚举。

映射键至少应包含渠道编码和产品类型。若同一产品在不同场景下需要不同交易类型,再增加场景字段,而不是修改平台产品枚举的含义。

下面示例使用 JDK 17,可直接保存为 PaymentMethodMappingDemo.java 编译运行。代码把商户请求中的支付方式转换为平台产品,再映射为指定渠道的交易类型。

java
import java.util.Map;

public class PaymentMethodMappingDemo {

    enum PayMethod {
        CARD, WALLET, QR_CODE
    }

    enum ProductType {
        CARD_PAYMENT, WALLET_PAYMENT
    }

    enum ChannelTradeType {
        SALE, WX_NATIVE, ALI_QR
    }

    record ChannelProductKey(String channelCode, ProductType productType) {}

    // 第一层映射只表达平台业务语义,不包含任何渠道协议值。
    private static final Map<PayMethod, ProductType> PRODUCT_MAPPING = Map.of(
            PayMethod.CARD, ProductType.CARD_PAYMENT,
            PayMethod.WALLET, ProductType.WALLET_PAYMENT,
            PayMethod.QR_CODE, ProductType.WALLET_PAYMENT
    );

    // 第二层映射集中隔离不同渠道的交易类型差异。
    private static final Map<ChannelProductKey, ChannelTradeType> TRADE_TYPE_MAPPING = Map.of(
            new ChannelProductKey("CARD_GATEWAY", ProductType.CARD_PAYMENT), ChannelTradeType.SALE,
            new ChannelProductKey("WECHAT_GATEWAY", ProductType.WALLET_PAYMENT), ChannelTradeType.WX_NATIVE,
            new ChannelProductKey("ALIPAY_GATEWAY", ProductType.WALLET_PAYMENT), ChannelTradeType.ALI_QR
    );

    public static ChannelTradeType resolve(String channelCode, PayMethod payMethod) {
        ProductType productType = PRODUCT_MAPPING.get(payMethod);
        ChannelTradeType tradeType = TRADE_TYPE_MAPPING.get(
                new ChannelProductKey(channelCode, productType)
        );
        if (tradeType == null) {
            // 缺失映射必须显式失败,避免误用默认交易类型。
            throw new IllegalArgumentException(
                    "Unsupported mapping: channel=" + channelCode + ", product=" + productType
            );
        }
        return tradeType;
    }

    public static void main(String[] args) {
        System.out.println(resolve("CARD_GATEWAY", PayMethod.CARD));
        System.out.println(resolve("WECHAT_GATEWAY", PayMethod.QR_CODE));
        System.out.println(resolve("ALIPAY_GATEWAY", PayMethod.WALLET));
    }
}

预期输出:

text
SALE
WX_NATIVE
ALI_QR

边界处理与持久化

无法映射时必须显式失败,不能悄悄回退到某个默认交易类型,否则请求可能被错误路由。渠道新增交易类型时,只修改该渠道适配器或映射表;只有平台真的增加一种独立业务能力时,才新增产品类型。

持久化时建议保存平台标准值,并在通道请求日志中额外记录最终渠道交易类型。这样既能保证订单数据长期稳定,又能在排查通道问题时还原真实报文。

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

目录与阅读设置

阅读设置

17

记录一个想法

支付方式标准化

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

登录哪都通