如何确保woocommerce_payment_complete动作在用户关浏览器后仍可靠执行？

方案1：使用WooCommerce Webhook（最推荐） #

直接利用WooCommerce内置的webhook功能，让WooCommerce服务器在订单支付完成时主动触发你的酒店预订API调用，完全不受前端浏览器状态影响。

操作步骤：

• 进入WooCommerce后台 → 设置 → 高级 → Webhooks
• 点击「添加webhook」，配置以下内容：
  • 状态：设为「发布」
  • 主题：选择「订单已支付（order.paid）」
  • 交付URL：填写你的酒店预订处理接口地址
  • 秘密：设置一个自定义密钥，用于验证请求合法性（避免伪造请求）
• 保存后，每当用户支付完成，WooCommerce会自动向你的接口发送订单数据，你只需在接口中处理酒店预订逻辑即可。

验证请求合法性的示例（PHP）：

// 获取WooCommerce发送的签名
$signature = $_SERVER['HTTP_X_WC_WEBHOOK_SIGNATURE'];
// 计算本地签名
$secret = '你设置的webhook密钥';
$payload = file_get_contents('php://input');
$local_signature = base64_encode(hash_hmac('sha256', $payload, $secret, true));

// 验证签名是否一致
if ($signature !== $local_signature) {
  http_response_code(403);
  exit('Invalid request');
}

// 处理酒店预订逻辑
$order_data = json_decode($payload, true);
// 调用酒店API...

方案2：前端改用Beacon API/Fetch Keepalive #

如果暂时不想改后端，可以修改前端支付成功后的触发逻辑，使用浏览器的Beacon API或带keepalive参数的Fetch，确保即使浏览器关闭，请求也能被后台完成发送。

示例代码（Beacon API）：

// 支付成功后触发的函数
function triggerHotelBooking(orderId) {
  const formData = new FormData();
  formData.append('order_id', orderId);
  // 发送Beacon请求，浏览器会在后台完成发送
  navigator.sendBeacon('/path/to/your/book-hotel-endpoint', formData);
}

示例代码（Fetch Keepalive）：

async function triggerHotelBooking(orderId) {
  await fetch('/path/to/your/book-hotel-endpoint', {
    method: 'POST',
    body: JSON.stringify({ order_id: orderId }),
    headers: { 'Content-Type': 'application/json' },
    keepalive: true // 关键参数，确保请求在浏览器关闭后仍能发送
  });
}

注意：Beacon API对请求大小有上限（通常64KB），如果你的请求数据较大，优先用Fetch Keepalive。

方案3：定时兜底检查（双重保障） #

不管用上面哪种方案，都可以再加一层定时任务，定期扫描已支付但未完成酒店预订的订单，补做预订操作，避免因网络波动等极端情况导致的遗漏。

如果是WordPress+WooCommerce环境，可以用WP Cron实现：

// 注册定时任务
add_action('init', function() {
  if (!wp_next_scheduled('check_unpaid_hotel_bookings')) {
    // 每小时执行一次，可根据需求调整频率
    wp_schedule_event(time(), 'hourly', 'check_unpaid_hotel_bookings');
  }
});

// 处理兜底检查的函数
add_action('check_unpaid_hotel_bookings', function() {
  // 查询已支付但未标记为已预订的订单
  $orders = wc_get_orders([
    'status' => 'completed',
    'meta_key' => '_hotel_booking_status',
    'meta_value' => 'pending',
    'meta_compare' => '='
  ]);

  foreach ($orders as $order) {
    // 调用酒店预订API
    $booking_response = wp_remote_post('https://your-hotel-api.com/book', [
      'body' => [
        'order_id' => $order->get_id(),
        'customer_email' => $order->get_billing_email(),
        'check_in' => $order->get_meta('_check_in_date'),
        // 其他必要参数
      ]
    ]);

    if (!is_wp_error($booking_response)) {
      // 标记订单为已预订
      update_post_meta($order->get_id(), '_hotel_booking_status', 'completed');
    } else {
      // 记录错误日志，方便排查
      error_log("酒店预订失败，订单ID：{$order->get_id()}，错误：{$booking_response->get_error_message()}");
    }
  }
});

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