Vendure电商平台中Mollie支付重复付款问题分析与解决方案

问题背景

在Vendure电商平台与Mollie支付网关的集成中，发现存在一个潜在问题：客户可能为同一订单进行多次支付。这种情况通常发生在以下场景：

1. 客户将商品加入购物车
2. 发起第一次支付请求并获取支付链接
3. 不完成第一次支付，而是再次发起支付请求获取新的支付链接
4. 分别完成两个支付链接的付款流程
5. 最终在Mollie后台可以看到同一订单产生了两个支付记录

技术分析

当前机制的问题

Vendure的支付插件当前实现存在以下不足：

1. 订单状态管理不够严格：在创建支付意图时，订单仍保持在"AddingItems"状态
2. 缺乏支付意图的跟踪：系统没有记录已创建的支付意图
3. 无并发支付控制：允许多个支付意图同时存在

Mollie支付特性

Mollie支付API有以下特点需要考虑：

1. 某些支付方式创建后无法取消
2. 支付订单一旦创建就具有独立生命周期
3. 支付状态变更通过webhook异步通知

解决方案设计

经过社区讨论和技术评估，最终确定以下改进方案：

核心改进点

1. 支付意图创建时的状态检查：

   • 在创建支付意图时验证订单是否可以过渡到"ArrangingPayment"状态
   • 但不实际执行状态转换，保持向后兼容

2. Mollie订单ID关联：

   • 将Mollie订单ID存储在Vendure订单上
   • 作为支付意图的唯一标识

3. 支付成功处理：

   • 通过Mollie webhook接收支付成功通知
   • 此时才将订单状态转为"ArrangingPayment"
   • 完成支付记录添加

4. 重复支付防护：

   • 检测到已有Mollie订单ID时
   • 尝试取消现有Mollie订单（如可取消）
   • 创建新的支付意图

方案优势

1. 无前端改动需求：保持现有前端交互逻辑不变
2. 渐进式改进：不影响现有订单流程
3. 容错设计：即使取消失败也不阻塞新支付

实现细节

状态管理策略

采用"乐观锁"思想处理订单状态：

1. 创建支付意图时仅检查状态转换可能性
2. 实际状态转换延迟到支付确认时
3. 通过Mollie订单ID关联支付与订单

异常处理

1. 对于不可取消的支付方式，记录日志但允许继续
2. 支付金额不足时自动转为"ArrangingAdditionalPayment"状态
3. 前端可选择处理部分支付场景

最佳实践建议

1. 前端实现建议：

   • 在支付确认页面检查订单状态
   • 处理部分支付完成的情况
   • 提供合并支付的引导

2. 监控建议：

   • 记录支付取消失败事件
   • 监控重复支付发生频率
   • 设置异常报警阈值

总结

该解决方案在保持系统兼容性的同时，有效降低了重复支付的风险。通过合理的状态管理和支付意图跟踪，为Vendure与Mollie的支付集成提供了更健壮的实现。开发者在实施时应注意支付方式的差异性，并做好异常情况的监控处理。