如何让WooCommerce Rest API创建的新订单直接使用自定义状态

要彻底避免通过REST API同步的订单进入Processing状态，需要从订单创建源头拦截默认状态，并阻止后续状态变更到Processing，以下是具体实现方案：

1. 从REST API创建订单时直接设置自定义状态 #

使用woocommerce_rest_insert_order_object过滤器，在订单保存到数据库前直接修改订单状态，这是最有效的源头拦截方式，能跳过WooCommerce默认的状态流转逻辑：

add_filter('woocommerce_rest_insert_order_object', 'rest_set_baselinker_order_status', 10, 3);
function rest_set_baselinker_order_status($order, $request, $creating) {
    // 仅对新创建的订单生效
    if (!$creating) return $order;

    // 验证是否为WooCommerce REST API请求（可根据BaseLinker的请求特征调整判断逻辑）
    if (isset($_SERVER['REQUEST_URI']) && strpos($_SERVER['REQUEST_URI'], '/wp-json/wc/') !== false) {
        // 直接设置自定义状态，跳过默认的pending/processing流程
        $order->set_status('baselinker', '订单通过BaseLinker REST API初始化至自定义状态', false);
        // 禁用自动邮件发送，确保不会触发任何状态通知
        $order->set_prop('send_email', false);
    }

    return $order;
}

2. 拦截后续状态变更，禁止切换到Processing #

如果BaseLinker后续仍会尝试修改订单状态，需要添加拦截逻辑，阻止订单从baselinker切换到processing：

add_action('woocommerce_before_order_status_change', 'block_processing_for_baselinker_orders', 10, 4);
function block_processing_for_baselinker_orders($order_id, $new_status, $old_status, $order) {
    // 当订单当前状态为baselinker，且目标状态为processing时，阻止变更
    if ($new_status === 'processing' && $old_status === 'baselinker') {
        // 强制将状态重置为baselinker，替代默认的processing变更
        remove_action(current_action(), __FUNCTION__);
        $order->update_status('baselinker', '阻止切换到Processing状态（符合外部平台合同要求）', true);
    }
}

3. 确保自定义状态已正确注册（如果未完成） #

如果之前的自定义状态baselinker未在WooCommerce中正式注册，需要添加以下代码完成注册，确保状态能正常显示和使用：

// 注册自定义订单状态
add_action('init', 'register_wc_baselinker_status');
function register_wc_baselinker_status() {
    register_post_status('wc-baselinker', array(
        'label'                     => 'BaseLinker',
        'public'                    => true,
        'exclude_from_search'       => false,
        'show_in_admin_all_list'    => true,
        'show_in_admin_status_list' => true,
        'label_count'               => _n_noop('BaseLinker <span class="count">(%s)</span>', 'BaseLinker <span class="count">(%s)</span>')
    ));
}

// 将自定义状态添加到WooCommerce订单状态列表
add_filter('wc_order_statuses', 'add_baselinker_to_wc_statuses');
function add_baselinker_to_wc_statuses($statuses) {
    $updated_statuses = array();
    foreach ($statuses as $key => $label) {
        $updated_statuses[$key] = $label;
        // 在Processing状态前插入自定义状态（可选，调整显示位置）
        if ($key === 'wc-processing') {
            $updated_statuses['wc-baselinker'] = 'BaseLinker';
        }
    }
    return $updated_statuses;
}

关键说明 #

• woocommerce_rest_insert_order_object是订单通过REST API创建时的核心过滤器，在订单写入数据库前执行，能彻底绕过默认的状态初始化逻辑。
• 禁用send_email属性可以确保任何状态变更都不会触发自动邮件/短信通知，符合你与外部平台的合同要求。
• 状态拦截逻辑可以根据BaseLinker的实际请求特征调整（比如检查请求头中的标识），让判断更精准。

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