WooCommerce自定义订单优惠券功能：Smart礼品卡金额为0问题求助

核心原因 #

WooCommerce Smart Coupons的礼品卡并非普通优惠券类型，它有独立的余额管理、抵扣计算逻辑，原生WC_Coupon类和apply_coupon()方法无法触发插件专属的礼品卡抵扣计算流程，导致看似应用成功但实际未计算余额抵扣。

解决方案 #

需要调用Smart Coupons插件提供的专用方法或钩子，替代原生优惠券应用逻辑，确保礼品卡的抵扣规则被正确执行。

方案1：区分礼品卡与普通优惠券，调用插件专属方法 #

$coupon_code = sanitize_text_field($_POST['coupon_code']);
$order = wc_get_order( $_POST['order_id'] ); // 确保正确获取订单对象

// 检查Smart Coupons插件是否激活
if (class_exists('WC_SC_Gift_Cards')) {
    // 尝试获取礼品卡对象
    $gift_card = WC_SC_Gift_Cards::get_gift_card_by_code($coupon_code);
    
    if ($gift_card && $gift_card->is_valid()) {
        // 使用插件专属方法应用礼品卡
        wc_sc_apply_gift_card_to_order($order, $gift_card);
        $order->calculate_totals();
        $order->save();
        wp_send_json_success('礼品卡已成功应用');
    }
}

// 非礼品卡场景，走原生优惠券逻辑
$coupon = new WC_Coupon($coupon_code);
if (!$coupon->get_id()) {
    wp_send_json_error('无效的优惠券/礼品卡');
}

$order->apply_coupon($coupon);
$order->calculate_totals();
$order->save();
wp_send_json_success('优惠券已成功应用');

方案2：通过插件钩子强制触发礼品卡计算逻辑 #

若无法直接调用插件类方法，可在原生优惠券应用后触发Smart Coupons的专属计算钩子：

$coupon_code = sanitize_text_field($_POST['coupon_code']);
$order = wc_get_order( $_POST['order_id'] );

$coupon = new WC_Coupon($coupon_code);
if (!$coupon->get_id()) {
    wp_send_json_error('无效的优惠券');
}

$order->apply_coupon($coupon);

// 触发Smart Coupons的礼品卡计算钩子，确保余额抵扣生效
if (did_action('woocommerce_sc_calculate_order_totals')) {
    do_action('woocommerce_sc_calculate_order_totals', $order);
}

$order->calculate_totals();
$order->save();

// 重新获取订单对象，确保数据更新
$updated_order = wc_get_order($order->get_id());
wp_send_json_success(array(
    'total' => wc_price($updated_order->get_total()),
    'discount_amount' => wc_price($updated_order->get_total_discount())
));

关键注意事项 #

1. 订单状态一致性：确保自定义支付页的订单状态与后台手动应用礼品卡时的状态一致（通常为pending或on-hold），状态异常可能导致插件拒绝计算抵扣。
2. 插件版本兼容性：上述方法基于Smart Coupons最新稳定版，若使用旧版本，需检查插件内部函数/类名是否有变更。
3. 权限验证：在处理AJAX请求时，务必添加check_ajax_referer()验证，防止恶意请求。

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