如何通过WooCommerce API按账单手机号筛选订单？

1. 修正自定义过滤代码 #

WooCommerce默认API不支持直接用billing_phone作为筛选参数，需要通过woocommerce_rest_orders_query钩子添加自定义查询逻辑。将以下代码添加到主题的functions.php文件中：

add_filter( 'woocommerce_rest_orders_query', 'filter_orders_by_billing_phone', 10, 2 );
function filter_orders_by_billing_phone( $args, $request ) {
    $billing_phone = $request->get_param( 'billing_phone' );
    if ( ! empty( $billing_phone ) ) {
        $args['meta_query'][] = array(
            'key'     => '_billing_phone',
            'value'   => $billing_phone,
            'compare' => '='
        );
    }
    return $args;
}

这段代码会读取API请求中的billing_phone参数，通过元查询精准匹配订单的_billing_phone元字段（WooCommerce存储账单手机号的字段名）。

2. 验证API请求格式 #

确保你的CURL请求包含有效的认证信息和精准的手机号参数：

curl -X GET "https://你的域名/wp-json/wc/v3/orders?billing_phone=目标手机号" \
-u "ck_你的消费者密钥:cs_你的消费者密钥密码"

注意：手机号要和订单中存储的格式完全一致（比如是否带区号、空格或特殊符号），否则会匹配失败。

3. 排查常见问题 #

• 检查functions.php中的代码是否有语法错误（比如括号不闭合、引号误用），导致钩子未生效。
• 确认目标订单的账单手机号字段确实存在有效值，可在WordPress后台订单详情页查看。
• 清理WordPress缓存和API缓存，确保新的过滤规则立即生效。

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