如何调整WooCommerce特定支付方式的订单预留库存时长以避免超卖

针对你遇到的加密货币支付延迟引发的库存超卖问题，以下是几个可行的解决方案：

1. 延长加密货币订单的库存锁定时长 #

WooCommerce默认会在订单pending状态15分钟后释放锁定的库存，这显然不匹配加密货币的交易速度。通过钩子自定义锁定时长，针对加密货币支付订单延长锁定时间：

add_filter('woocommerce_hold_stock_minutes', 'extend_crypto_order_stock_hold', 10, 2);
function extend_crypto_order_stock_hold($minutes, $order) {
    if (!$order) return $minutes;
    // 替换为你的加密货币支付网关ID（可在WooCommerce支付设置中查看）
    $crypto_gateway_ids = ['crypto_payment', 'bitcoin_gateway'];
    if (in_array($order->get_payment_method(), $crypto_gateway_ids)) {
        return 360; // 锁定6小时，可根据区块链确认时间调整
    }
    return $minutes;
}

将这段代码添加到主题的functions.php文件或自定义插件中，确保加密货币订单的库存不会提前释放。

2. 禁止自动取消加密货币pending订单 #

默认WooCommerce会自动取消未支付的订单，这会导致库存提前释放。针对加密货币订单禁用自动取消：

add_filter('woocommerce_cancel_unpaid_orders', 'exclude_crypto_orders_from_auto_cancel', 10, 2);
function exclude_crypto_orders_from_auto_cancel($should_cancel, $order) {
    $crypto_gateway_ids = ['crypto_payment', 'bitcoin_gateway'];
    if (in_array($order->get_payment_method(), $crypto_gateway_ids)) {
        return false; // 不自动取消加密货币pending订单
    }
    return $should_cancel;
}

注意：需要定期手动清理超过合理时间（如24小时）仍未确认的加密货币订单，避免库存被长期占用。

3. 延迟库存扣减至支付确认后 #

修改库存扣减时机，从下单时扣减改为支付完成（订单状态变为completed或processing）时再扣减：

// 移除默认的下单时库存扣减动作
remove_action('woocommerce_checkout_order_processed', 'woocommerce_reduce_stock_levels');
// 添加支付完成时的库存扣减动作
add_action('woocommerce_order_status_completed', 'woocommerce_reduce_stock_levels');
add_action('woocommerce_order_status_processing', 'woocommerce_reduce_stock_levels');

这种方式需要确保加密货币支付确认后，订单状态会自动更新为completed或processing。同时，若订单最终取消且已扣减库存，需手动恢复库存（或添加钩子自动处理）。

4. 针对加密货币专属商品单独管理库存 #

如果只有部分商品支持加密货币销售，可给这类商品添加自定义字段（如crypto_exclusive），然后针对这些商品应用特殊库存规则：

add_filter('woocommerce_hold_stock_minutes', 'extend_crypto_product_stock_hold', 10, 2);
function extend_crypto_product_stock_hold($minutes, $order) {
    if (!$order) return $minutes;
    $has_crypto_product = false;
    foreach ($order->get_items() as $item) {
        $product = $item->get_product();
        // 检查商品是否有加密货币专属标记
        if ($product->get_meta('crypto_exclusive') === 'yes') {
            $has_crypto_product = true;
            break;
        }
    }
    if ($has_crypto_product) {
        return 360;
    }
    return $minutes;
}

设置自定义字段可通过WooCommerce商品编辑页的“自定义字段”模块完成，或使用自定义插件实现。

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