WooCommerce自定义支付网关支付成功后订单仍处于On-hold状态排查

从你提供的代码来看，订单交易成功后仍处于'on-hold'（待处理）状态，主要有几个潜在问题：

1. 订单状态判断方式错误 #

WooCommerce 3.0版本之后，订单对象的属性访问已改用getter/setter方法，直接访问$order->status属于旧写法，可能无法正确获取订单的真实状态。比如订单实际是'on-hold'，但旧写法获取的状态值不正确，会导致跳过payment_complete()的执行逻辑。

修复方式：把所有判断订单状态的代码换成$order->get_status()，示例：

if($order->get_status() == 'processing'){
    //do nothing
}

2. 购物车清空逻辑存在变量隐患 #

代码中使用$woocommerce->cart->empty_cart()，但未提前声明全局变量$woocommerce，更推荐用WooCommerce官方的全局对象调用方式WC()->cart，避免因变量未初始化导致的流程异常（虽不是状态问题的直接原因，但会影响后续逻辑）。

修复方式：替换为：

WC()->cart->empty_cart();

3. payment_complete()调用可更规范 #

payment_complete()方法支持传入交易参考号作为参数，这样会自动把交易ID关联到订单中，确保状态更新逻辑完整执行。

优化方式：修改为：

$order->payment_complete($payRef);

额外排查点 #

若修改上述代码后问题仍存在，需检查：

• WooCommerce后台设置：进入「WooCommerce > 设置 > 支付」，确认当前支付网关的设置是否有特殊状态控制选项；另外在「WooCommerce > 设置 > 产品 > 库存」中，检查“处理订单时减少库存”的选项是否开启，这可能影响订单状态流转。
• 是否有其他插件或自定义代码干扰：比如库存管理、订单管理类插件可能修改订单状态的自动流转逻辑，可暂时禁用其他插件排查。

修改后的核心代码片段：

if($successCode == "0"){                                
    if($order->get_status() == 'processing'){
        //do nothing
    }else{                                  
        $this->msg['message'] = '感谢您的购买！您的账户已扣款，交易成功。我们将尽快为您发货。支付参考号：' . $payRef;
        $this->msg['class'] = 'woocommerce_message';
        
        $order->payment_complete($payRef);
        $order->add_order_note('支付成功！支付参考号：'.$payRef);
        WC()->cart->empty_cart();   
        echo ' - 支付成功！';
    }
}else{  
    if($order->get_status() == 'processing'){
        //do nothing
    }else{                          
        $this->msg['message'] = '感谢您的购买，但交易已被拒绝。支付参考号：'. $payRef;
        $this->msg['class'] = 'woocommerce_error';
        
        $order->update_status('failed');
        $order->add_order_note('抱歉！支付失败！支付参考号：'.$payRef);                               
        echo ' - 支付失败！';
    }
}

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