阻止指定支付方式的WooCommerce订单从已取消状态变更

原代码使用woocommerce_order_status_changed钩子的核心问题是：这个动作是订单状态已经完成变更后才触发的。此时WooCommerce可能已经同步调整了库存、发送了用户通知，再强制改回cancelled状态不仅可能失效，还会导致数据不一致（比如库存无法回滚）。

正确的做法是在订单状态变更前直接拦截，使用woocommerce_order_status_transition钩子——这个钩子专门用于在状态转换生效前进行校验和阻止。

修正后的状态拦截代码 #

add_action('woocommerce_order_status_transition', 'prevent_cancelled_crypto_order_status_change', 10, 3);

function prevent_cancelled_crypto_order_status_change($order, $from_status, $to_status) {
    // 定义需要限制的加密货币支付方式ID
    $restricted_payment_methods = ['coinbase', 'coinpayments'];
    $payment_method = $order->get_payment_method();

    // 校验拦截条件：支付方式匹配、原状态为已取消、目标状态为待处理/已完成
    if (in_array($payment_method, $restricted_payment_methods) 
        && $from_status === 'cancelled' 
        && in_array($to_status, ['pending', 'completed'])) {
        
        // 添加后台订单备注，记录拦截操作
        $order->add_order_note('状态变更被阻止：不允许已取消的加密货币订单转为待处理或已完成状态');
        
        // 抛出异常中断状态转换流程（WooCommerce官方认可的阻止方式）
        throw new Exception('状态转换被拦截：已取消的加密货币订单无法恢复');
    }
}

代码关键点说明 #

1. 钩子时机：woocommerce_order_status_transition在状态变更前触发，能直接中断转换流程，避免后续的库存、通知等连锁操作。
2. 简洁判断：用in_array替代重复的||判断，代码更易维护。
3. 可靠阻止：抛出异常是WooCommerce内部处理状态转换的标准拦截方式，比事后改状态更稳定。

针对核心库存问题的额外优化 #

你的核心需求是避免库存负数，除了拦截状态变更，还需要优化加密货币订单的库存锁定逻辑——默认WooCommerce在订单取消时会自动恢复库存，这会导致待处理的加密货币订单超时取消后，库存被释放引发重复购买：

add_filter('woocommerce_can_restock_order', 'prevent_crypto_order_restock', 10, 3);

function prevent_crypto_order_restock($can_restock, $order, $product) {
    $restricted_payment_methods = ['coinbase', 'coinpayments'];
    // 待处理状态的加密货币订单取消时，不恢复库存
    if (in_array($order->get_payment_method(), $restricted_payment_methods) 
        && $order->get_status() === 'pending') {
        return false;
    }
    return $can_restock;
}

这段代码可以确保：用户A的加密货币订单在pending状态（区块链处理中）时，即使因超时被系统取消，库存也不会被释放，避免用户B购买同款商品导致后续库存负数。

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