Woocommerce：Stripe Sofort支付订单自定义状态修改代码失效排查

可能的失效原因 #

• 钩子时机不匹配：woocommerce_thankyou在用户跳转回感谢页时触发，但Stripe Sofort是异步支付方式，此时订单可能还未同步更新到on-hold状态，导致条件判断不成立。
• 支付方法ID错误：需确认Stripe Sofort的支付方法ID是否为stripe_sofort，部分版本中可能是stripe_sofort_payment或其他变体，可在WooCommerce后台「支付设置」中查看对应支付方式的ID。
• 自定义状态未注册：my_status作为自定义订单状态，必须提前通过代码注册到WooCommerce系统中，否则update_status方法无法识别该状态，操作无效。
• 订单对象获取异常：wc_get_order可能因订单未完全创建、权限问题等无法正确获取订单对象，导致后续逻辑无法执行。

调试与修正方案 #

1. 添加调试日志排查：在代码中加入日志输出，定位关键节点是否执行：

add_action( 'woocommerce_thankyou', 'woocommerce_auto_processing_orders');
function woocommerce_auto_processing_orders( $order_id ) {
    if ( ! $order_id ) {
        error_log('订单ID为空');
        return;
    }

    $order = wc_get_order( $order_id );
    if( !$order ) {
        error_log('无法获取订单，ID：'.$order_id);
        return;
    }

    error_log('当前订单支付方式：'.$order->get_payment_method());
    error_log('当前订单状态：'.$order->get_status());

    if( $order->get_payment_method() == 'stripe_sofort' && $order->has_status( 'on-hold' ) ) {
        $order->update_status( 'my_status' );
        error_log('订单状态已更新为my_status');
    }
}

可通过服务器日志或WooCommerce日志功能查看输出，定位具体问题点。

2. 改用适配异步支付的钩子：针对Stripe异步支付，推荐使用官方提供的支付成功钩子wc_stripe_payment_intent_succeeded，确保支付确认后再更新状态：

// 先注册自定义订单状态（必须步骤）
add_action( 'init', 'register_custom_order_status' );
function register_custom_order_status() {
    register_post_status( 'wc-my_status', array(
        'label'                     => '自定义状态',
        'public'                    => true,
        'exclude_from_search'       => false,
        'show_in_admin_all_list'    => true,
        'show_in_admin_status_list' => true,
        'label_count'               => _n_noop( '自定义状态 (%s)', '自定义状态 (%s)' )
    ) );
}

add_filter( 'wc_order_statuses', 'add_custom_order_status_to_admin' );
function add_custom_order_status_to_admin( $statuses ) {
    $statuses['wc-my_status'] = '自定义状态';
    return $statuses;
}

// 支付成功后更新状态
add_action( 'wc_stripe_payment_intent_succeeded', 'update_sofort_order_status', 10, 3 );
function update_sofort_order_status( $payment_intent, $order, $stripe_source ) {
    if ( $order->get_payment_method() === 'stripe_sofort' ) {
        $order->update_status( 'my_status', 'Stripe Sofort支付完成，自动更新为自定义状态' );
    }
}

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