Drupal Commerce对接PayPal：跳转支付前强制重算订单方案问询

摘要 #

若自动生效的促销活动在跳转外部支付前被发布或取消发布，客户被收取的金额可能与支付步骤面板显示的金额不一致。

环境 #

• Drupal: 10.x
• Commerce: 2.x
• Payment 模块: commerce_paypal

重现步骤 #

1. 某商品存在生效的促销折扣活动。
2. 客户将商品加入购物车并进入结账的支付步骤。
3. 客户保持支付页面打开约1小时（无任何操作）。
4. 期间促销活动到期，由调度器自动取消发布。
5. 支付页面仍向用户显示折扣后的总价。
6. 客户通过PayPal智能按钮（Commerce PayPal模块）完成支付。
7. 问题出现：PayPal收取全额（无折扣），与用户看到的折扣后总价不符。

实际结果 #

显示总价与实付总价不匹配，引发用户困惑、投诉及退款诉求。

预期结果 #

在跳转至远程支付前，自动刷新/重算订单（移除过期促销）；若总价发生变更，需向用户发出警告并要求重新确认。

核心问题与实现方案 #

推荐实现方式 #

通过Drupal Commerce的事件系统，在支付请求发起前强制触发服务器端订单重算，并校验总价一致性：

1. 订单重算逻辑：调用Commerce核心的Order::recalculateTotalPrice()方法，重新计算促销、税费及所有调整项。
2. 总价校验：对比重算前后的订单总价，若存在差异则阻止支付流程，并向用户展示明确提示。
3. 触发时机：选择在支付创建前的事件节点介入，确保支付网关接收到的是最新、准确的订单总价。

补充问题解答 #

1. 是否有现成模块或实现模式处理过期结账页面/价格偏差？ #

Drupal Commerce 2.x暂无直接对应贡献模块，但社区有成熟的实现思路，可通过核心钩子/事件系统完成：

• commerce_order.pre_transition事件：在订单状态转换到支付相关状态（如payment）前触发，执行订单重算与校验。
• hook_commerce_order_presave()钩子：在订单保存前强制重算，但需添加条件判断，仅在支付流程节点触发，避免影响其他订单操作场景。

2. PayPal模块相关钩子/事件确保支付前订单刷新？ #

针对Commerce PayPal模块，可通过commerce_payment.pre_create_payment事件介入，在创建PayPal支付请求前完成订单重算与校验。以下是代码示例：

/**
 * Implements hook_event_subscriber().
 */
function my_custom_module_event_subscriber() {
  $subscribers = [];
  $subscribers['my_custom_module_payment_pre_create'] = [
    'callback' => 'my_custom_module_payment_pre_create',
    'priority' => 100, // 设置高优先级确保先执行重算
  ];
  return $subscribers;
}

/**
 * Callback for commerce_payment.pre_create_payment event.
 */
function my_custom_module_payment_pre_create(\Drupal\commerce_payment\Event\PaymentPreCreateEvent $event) {
  $order = $event->getOrder();
  
  // 保存原始总价用于对比
  $original_total = $order->getOriginal('total_price')->getNumber();
  // 强制重算订单总价
  $order->recalculateTotalPrice();
  $new_total = $order->getTotalPrice()->getNumber();
  
  // 校验总价是否变更
  if ($original_total != $new_total) {
    // 抛出异常阻止支付流程，前端将收到错误提示
    throw new \Drupal\Core\Form\FormErrorException('订单总价已更新，请重新确认订单后再尝试支付。');
  }
  
  // 保存重算后的订单（若重算后总价无变更，仍需确保订单数据最新）
  $order->save();
}

若使用PayPal智能按钮，也可在按钮回调的服务器端逻辑中加入相同的重算与校验步骤，确保支付请求携带最新总价。

约束条件 #

• 严格禁止收取与用户确认的UI总价不符的金额。
• 优先采用服务器端强制机制，避免仅依赖前端JS校验，防止恶意绕过前端逻辑导致的价格偏差。

内容的提问来源于stack exchange，提问作者MastaP