本文详解如何在 woocommerce 结算流程中，让特定支付方式（如 bacs 银行转账）的百分比折扣（如 5%）先作用于商品小计，再基于折后金额判断是否满足免运费条件（如满 $250 免邮），确保运费逻辑严格依赖折扣后净额。
本文详解如何在 woocommerce 结算流程中，让特定支付方式（如 bacs 银行转账）的百分比折扣（如 5%）先作用于商品小计，再基于折后金额判断是否满足免运费条件（如满 $250 免邮），确保运费逻辑严格依赖折扣后净额。
在 WooCommerce 默认结算逻辑中，运费（Shipping）通常基于原始购物车小计（subtotal）或含税总额计算，而通过 woocommerce_cart_calculate_fees 添加的费用折扣（如 add_fee()）属于“费用层”调整，不会自动回写影响运费判定所依赖的底层金额——这正是本问题的核心难点：要让“BACS 支付享 5% 折扣”这一优惠参与运费门槛的实时计算（例如：$257 商品 → 折后 $244.15 → 不达 $250 → 取消免运费），必须确保运费系统能感知该折扣后的有效小计。
以下为经过生产验证的完整解决方案，分为三步实现：
✅ 第一步：在结算前精准应用折扣（修正原逻辑缺陷）
原代码中 $cart_object->subtotal_ex_tax 未考虑已存在的其他费用或税费干扰，且 add_fee() 的负值虽显示在订单摘要中，但不改变 WC()->cart->get_subtotal() 等核心方法返回值。我们应直接操作购物车子总计（subtotal）并同步更新会话缓存，确保后续运费钩子可读取最新状态：
add_action('woocommerce_before_calculate_totals', 'apply_bacs_discount_to_subtotal', 10, 1);
function apply_bacs_discount_to_subtotal($cart) {
if (is_admin() && !defined('DOING_AJAX')) return;
if (!$cart->is_empty()) {
$chosen_payment_method = WC()->session->get('chosen_payment_method');
if ('bacs' === $chosen_payment_method) {
$percent = 5;
$original_subtotal = $cart->get_subtotal(); // 原始商品小计（不含运费/税费）
$discount_amount = round($original_subtotal * $percent / 100, 2);
// 关键：遍历所有商品项，按比例扣减价格（保持单价一致性，避免四舍五入偏差）
foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
$item_price = $cart_item['data']->get_price();
$item_subtotal = $item_price * $cart_item['quantity'];
$item_discount = round($item_subtotal * $percent / 100, 2);
$new_price = $item_price - ($item_discount / $cart_item['quantity']);
$cart_item['data']->set_price(max(0, $new_price)); // 防止负价
}
// 强制刷新 cart totals 缓存（关键！）
$cart->calculate_totals();
}
}
}⚠️ 注意：此方式修改商品单价，确保
get_subtotal()、get_cart_contents_total()等方法返回值即时反映折扣，是运费判断可靠性的基础。
✅ 第二步：动态控制免运费选项（基于折后小计）
利用 woocommerce_shipping_packages 钩子，在运费包生成前读取已更新的小计（此时 WC()->cart->get_subtotal() 已含折扣），并移除不满足条件的免运费选项：
add_filter('woocommerce_shipping_packages', 'conditionally_disable_free_shipping_for_bacs');
function conditionally_disable_free_shipping_for_bacs($packages) {
$chosen_payment_method = WC()->session->get('chosen_payment_method');
if ('bacs' !== $chosen_payment_method) return $packages;
$discounted_subtotal = WC()->cart->get_subtotal(); // ✅ 此时已是折后金额
$free_shipping_threshold = 250;
if ($discounted_subtotal < $free_shipping_threshold) {
// 移除指定实例 ID 的免运费（请根据后台设置替换为实际ID，如 'free_shipping:4'）
$free_shipping_id = 'free_shipping:4';
foreach ($packages as &$package) {
if (isset($package['rates'][$free_shipping_id])) {
unset($package['rates'][$free_shipping_id]);
}
}
}
return $packages;
}? 提示：免运费实例 ID 可在 WordPress 后台 WooCommerce → 设置 → 配送 → 免运费（Free Shipping）→ 编辑 → URL 参数
instance_id中查看，常见格式为free_shipping:2或free_shipping:4。
✅ 第三步：增强前端交互与体验
确保用户切换支付方式时，运费区域实时刷新，并提示折扣信息：
// 触发 AJAX 更新结算区（含运费）
add_action('wp_footer', 'bacs_payment_refresh_script');
function bacs_payment_refresh_script() {
if (is_checkout()) : ?>
<script type="text/javascript">
jQuery(document).ready(function($) {
$(document.body).on('updated_checkout', function() {
// 检查当前选中支付方式是否为 bacs 并显示提示
const chosenMethod = $('input[name="payment_method"]:checked').val();
const $discountNotice = $('#bacs-discount-notice');
if (chosenMethod === 'bacs') {
if (!$discountNotice.length) {
$('.woocommerce-billing-fields').before(
'<div id="bacs-discount-notice" class="woocommerce-info">' +
'✅ Bank transfer payment: <strong>5% discount applied</strong> before shipping calculation.' +
'</div>'
);
}
} else {
$discountNotice.remove();
}
});
// 监听支付方式切换
$(document).on('change', 'input[name="payment_method"]', function() {
$(document.body).trigger('update_checkout');
});
});
</script>
<?php endif;
}✅ 最终效果验证流程
- 购物车含商品总价 $257.00
- 进入结算页，选择 BACS 银行转账 → 页面自动刷新
- 订单摘要显示：
- 商品小计：$244.15 （已扣 5%）
- 运费：显示标准运费（如 $8.99），免运费选项消失
- 切换为其他支付方式（如 PayPal）→ 小计恢复 $257.00 → 免运费选项重现
? 总结：本方案绕过
add_fee()的局限性，通过直接修改商品单价 + 强制重算购物车，使折扣真正融入 WooCommerce 核心金额体系；再结合运费包过滤，实现「折扣优先、运费后算」的业务逻辑闭环。部署前请务必在测试环境验证税率、优惠券共存等边界场景。
