如何阻止WooCommerce自动将订单状态从Pending payment改为On hold

核心原因 #

这种情况一般是支付网关的回调逻辑触发了订单状态自动更新，或是WooCommerce默认的状态流转规则被第三方插件/自定义代码修改导致。

解决方法 #

1. 通过钩子拦截状态变更 #

在主题的functions.php文件或自定义插件中添加以下代码，直接阻止pending到on-hold的状态流转：

add_filter( 'woocommerce_order_status_transition', 'block_pending_to_onhold', 10, 3 );
function block_pending_to_onhold( $new_status, $old_status, $order ) {
    // 仅拦截从pending到on-hold的状态变更
    if ( $old_status === 'pending' && $new_status === 'on-hold' ) {
        return $old_status; // 保留原状态，阻止变更
    }
    return $new_status;
}

如果需要同时取消支付网关触发的默认状态更新动作，可额外添加：

add_action( 'woocommerce_order_status_pending_to_on-hold', 'remove_default_payment_complete_action', 9 );
function remove_default_payment_complete_action() {
    remove_action( 'woocommerce_order_status_pending_to_on-hold', 'wc_payment_complete', 10 );
}

2. 检查支付网关设置 #

• 进入WooCommerce后台，依次打开WooCommerce > 设置 > 支付
• 找到当前使用的支付网关（如PayPal、Stripe），查看是否有「自动将待支付订单转为保留状态」的选项，直接关闭该设置
• 部分网关会在支付初始化后自动修改订单状态，需调整网关的回调逻辑或状态映射配置

3. 排查插件冲突 #

• 暂时禁用所有WooCommerce相关第三方插件，测试下单流程，确认状态是否恢复正常
• 若恢复正常，逐个重新启用插件，定位出导致状态异常的插件后，联系开发者修复或替换插件

注意：修改主题代码前请做好备份，避免代码错误导致网站故障；不熟悉代码操作的话，建议使用自定义插件添加代码，或寻求专业开发者协助。

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