架构与系统设计 / 系统课时
支付方式标准化
支付方式标准化
本课解决支付平台中“同一种付款能力被不同系统用不同名称表达”的问题。完成后,你将建立统一的支付方式、产品类型与渠道交易类型模型,并用一处映射代码隔离渠道差异。
学习目标
- 区分支付方式、产品类型和渠道交易类型的职责
- 设计稳定的标准枚举与渠道映射关系
- 通过可运行示例验证映射结果与异常边界
三层模型分别解决什么问题
支付方式描述用户“怎么付”,例如银行卡、电子钱包或二维码;产品类型描述平台“卖给商户什么能力”,例如银行卡收单、钱包支付;渠道交易类型则是下游通道真正接收的协议值。三者不能混为一个枚举,否则新增通道时会不断污染平台模型。
| 层级 | 面向对象 | 示例 | 稳定性 |
|---|---|---|---|
| 支付方式 | 商户与前端 | 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边界处理与持久化
无法映射时必须显式失败,不能悄悄回退到某个默认交易类型,否则请求可能被错误路由。渠道新增交易类型时,只修改该渠道适配器或映射表;只有平台真的增加一种独立业务能力时,才新增产品类型。
持久化时建议保存平台标准值,并在通道请求日志中额外记录最终渠道交易类型。这样既能保证订单数据长期稳定,又能在排查通道问题时还原真实报文。
按自己的节奏,确认真正理解。