WooCommerce最低订单金额自动补差额功能：如何将差额同步至最终订单

嘿，我明白你的问题了！你之前的代码确实能修改显示的总价，但核心问题是——这笔差额没有被当成一个实际的订单项目添加进去，所以用户提交订单时，系统根本不会把这笔钱算进去。咱们得把这个差额做成一个像运费一样的独立收费项，让它在购物车、结账页都能显示，而且最终能被正确计入订单金额里。

问题根源 #

直接修改WC()->cart->total只是改动了前端显示的数值，并没有在WooCommerce的订单计算逻辑里添加实际的费用项，所以提交订单时这笔差额不会被系统识别和统计。正确的做法是用WooCommerce专门的钩子来添加自定义费用。

修改后的完整代码 #

// 添加最低订单金额差额作为自定义收费项
add_action( 'woocommerce_cart_calculate_fees', 'add_minimum_order_surcharge' );
function add_minimum_order_surcharge() {
    // 只在购物车和结账页面触发
    if ( ! is_cart() && ! is_checkout() ) return;

    $minimum = get_option( 'cart_minimum_total' );
    // 确保最低金额是有效数字
    if ( ! is_numeric( $minimum ) || $minimum <= 0 ) return;

    $cart_subtotal = WC()->cart->subtotal;

    // 当购物车小计低于最低金额时，计算差额并添加收费项
    if ( $cart_subtotal < $minimum ) {
        $difference = $minimum - $cart_subtotal;
        // add_fee参数：费用名称、金额、是否含税、费用类别
        WC()->cart->add_fee( 
            esc_html__( '最低订单金额差额', 'myplugin' ), 
            $difference, 
            false, 
            '' 
        );
    }
}

// 可选：在订单总额下方添加说明文字
add_action( 'woocommerce_review_order_after_order_total', 'show_minimum_order_note' );
add_action( 'woocommerce_cart_totals_after_order_total', 'show_minimum_order_note' );
function show_minimum_order_note() {
    $minimum = get_option( 'cart_minimum_total' );
    if ( WC()->cart->subtotal < $minimum ) {
        echo '<tr class="minimum-order-note">';
        echo '<th colspan="2">'.esc_html__( '提示：订单最低金额为 ', 'myplugin' ).esc_html( $minimum ).' €，差额已自动补足', 'myplugin' ).'</th>';
        echo '</tr>';
    }
}

代码关键点说明 #

1. 使用正确的钩子：woocommerce_cart_calculate_fees是WooCommerce官方推荐的添加自定义费用的钩子，添加的费用会被系统自动纳入订单计算逻辑，包括前端显示、支付统计、后台订单记录。
2. 独立收费项：通过WC()->cart->add_fee添加的费用会作为一个单独的项目出现在购物车和结账页面，和运费、税费一样清晰可见，用户能明白这笔钱的用途。
3. 灵活配置：你可以修改费用名称（比如改成英文或更贴合店铺的表述），如果需要对差额收税，只需要把add_fee的第三个参数改成true即可。

测试验证步骤 #

1. 清空购物车，添加总价低于15€的商品，查看购物车页面，应该能看到“最低订单金额差额”的收费项，订单总额自动变为15€（加上运费的话是15€+运费）。
2. 进入结账页面，确认收费项存在且总额正确。
3. 提交订单后，在后台查看订单详情，这笔差额会作为订单的一部分被记录下来。

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