WooCommerce后台修改订单支付方式时无法捕获新支付方法的问题

问题根源分析 #

你当前的代码无法正确获取新支付方法，核心原因有两个：

1. DOM选择器不准确：WooCommerce后台订单编辑页的支付方法下拉框结构和你写的多层嵌套选择器不匹配，导致无法拿到选中值。
2. 事件触发时机冲突：点击save_order按钮时，WooCommerce会优先提交表单更新订单，你的AJAX请求要么拿到旧值，要么订单更新后对比逻辑失效。

修正后的完整方案 #

方案1：使用WooCommerce内置钩子（推荐，更稳定） #

直接利用后台订单保存的官方钩子，无需前端代码，彻底避免DOM和时机问题：

add_action('woocommerce_process_shop_order_meta', 'add_payment_method_change_note', 10, 2);
function add_payment_method_change_note($order_id, $post) {
    // 获取操作用户
    $current_user = wp_get_current_user();
    $user_name = $current_user->display_name;

    // 获取订单对象及新旧支付方法
    $order = wc_get_order($order_id);
    $old_payment_method = $order->get_payment_method();
    $new_payment_method = isset($_POST['_payment_method']) ? sanitize_text_field($_POST['_payment_method']) : '';

    // 对比后添加备注
    if (!empty($new_payment_method) && $new_payment_method !== $old_payment_method) {
        // 转换为友好的支付方法名称
        $old_method_name = wc_get_payment_method_label($old_payment_method);
        $new_method_name = wc_get_payment_method_label($new_payment_method);
        
        $note = sprintf('订单由%s修改：支付方式从「%s」变更为「%s」', $user_name, $old_method_name, $new_method_name);
        $order->add_order_note($note);
        $order->save();
    }
}

方案2：修复原JS+AJAX逻辑（保留前端触发场景） #

如果需要保留前端交互逻辑，修正选择器和事件时机：

add_action('woocommerce_admin_order_data_after_billing_address', 'enforce_order_payment_note_script');
function enforce_order_payment_note_script() {
    global $post;
    $order_id = $post->ID;
    $current_user = wp_get_current_user();
    $user_name = $current_user->display_name;
    ?>
    <script>
    jQuery(document).ready(function($) {
        // 提前监听支付方法变化，存储新值
        let newPaymentMethod = '';
        $('select#_payment_method').on('change', function() {
            newPaymentMethod = $(this).val();
        });

        // 拦截保存按钮，先执行AJAX再提交表单
        $('.save_order').on('click', function(e) {
            const $btn = $(this);
            if (!newPaymentMethod) return;

            e.preventDefault();
            
            $.ajax({
                url: '<?php echo admin_url('admin-ajax.php'); ?>',
                type: 'POST',
                data: {
                    action: 'update_order_payment_note',
                    order_id: <?php echo $order_id; ?>,
                    user_name: '<?php echo esc_js($user_name); ?>',
                    new_payment_method: newPaymentMethod
                },
                success: function() {
                    $btn.closest('form').submit();
                },
                error: function() {
                    $btn.closest('form').submit();
                }
            });
        });
    });
    </script>
    <?php
}

add_action('wp_ajax_update_order_payment_note', 'update_order_payment_note_callback');
function update_order_payment_note_callback() {
    if (!isset($_POST['order_id']) || !current_user_can('edit_shop_orders')) {
        wp_send_json_error();
    }

    $order_id = intval($_POST['order_id']);
    $user_name = sanitize_text_field($_POST['user_name']);
    $new_payment_method = sanitize_text_field($_POST['new_payment_method']);

    $order = wc_get_order($order_id);
    $old_payment_method = $order->get_payment_method();

    if ($new_payment_method !== $old_payment_method) {
        $old_method_name = wc_get_payment_method_label($old_payment_method);
        $new_method_name = wc_get_payment_method_label($new_payment_method);
        
        $note = sprintf('订单由%s修改：支付方式从「%s」变更为「%s」', $user_name, $old_method_name, $new_method_name);
        $order->add_order_note($note);
        $order->save();
        
        wp_send_json_success();
    } else {
        wp_send_json_error();
    }
}

关键优化说明 #

1. 选择器简化：直接用select#_payment_method，WooCommerce后台支付方法下拉框的固定ID就是_payment_method，避免多层嵌套选择器的兼容性问题。
2. 事件逻辑调整：提前监听支付方法变化存储新值，拦截保存按钮先执行AJAX，确保拿到的是最新选择的支付方法。
3. 用户体验优化：方案1无需前端代码，完全依赖官方钩子，稳定性更高；方案2即使AJAX失败也会提交表单，不阻塞用户操作。
4. 备注可读性提升：用wc_get_payment_method_label()将支付方法slug转换为友好名称（如从paypal转为PayPal），备注更易理解。

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