WooCommerce: как избежать повторной оплаты при проблемах с samesite cookie

Диагностика проблемы с повторной оплатой в WooCommerce

Повторная оплата возникает, когда клиент нажимает кнопку оплаты, но по техническим причинам платеж не проходит или страница заказа обновляется, и клиент пытается оплатить повторно. Частой причиной является некорректная работа cookie с атрибутом SameSite, особенно при использовании сторонних платежных систем и сессий, нарушенных политиками браузеров.

Проверить проблему можно так:

• Откройте консоль браузера (F12) и перейдите на вкладку Application > Cookies.
• Найдите cookie сессии WooCommerce (woocommerce_cart_hash, woocommerce_items_in_cart и PHPSESSID).
• Проверьте атрибут SameSite. Если он отсутствует или установлен неправильно, это может привести к конфликтам.
• Проверьте логи платежного шлюза на предмет повторных попыток оплаты.

Почему SameSite cookie важен для WooCommerce

Атрибут SameSite определяет, будут ли cookie отправляться вместе с кросс-доменными запросами. Неправильная настройка приводит к тому, что сессия в WooCommerce теряется при возврате с платежной системы, и заказ либо не завершается, либо создаётся дублирующий.

Варианты атрибута SameSite

Пошаговое решение: настройка SameSite cookie для WooCommerce

1. Убедитесь, что сайт работает по HTTPS. Атрибут SameSite=None требует защищённого соединения.

2. Добавьте в functions.php вашей темы или в собственный плагин следующий код для установки атрибутов cookie сессии:

add_action('init', function() {
    if (session_status() === PHP_SESSION_NONE) {
        session_set_cookie_params([
            'lifetime' => 0,
            'path' => COOKIEPATH,
            'domain' => COOKIE_DOMAIN,
            'secure' => is_ssl(),
            'httponly' => true,
            'samesite' => 'Lax' // или 'None' если HTTPS
        ]);
        session_start();
    }
});

3. Для WooCommerce cookie, которые устанавливаются через PHP setcookie, можно перехватить их установку через фильтр woocommerce_cookie_path и функцию setcookie с параметром samesite (начиная с PHP 7.3). Но WooCommerce не имеет встроенного фильтра для атрибута SameSite, поэтому используйте хуки PHP:

add_action('send_headers', function() {
    if (headers_sent()) {
        return;
    }
    foreach ($_COOKIE as $name => $value) {
        if (strpos($name, 'woocommerce') !== false) {
            setcookie($name, $value, [
                'expires' => time() + 3600,
                'path' => COOKIEPATH,
                'domain' => COOKIE_DOMAIN,
                'secure' => is_ssl(),
                'httponly' => false,
                'samesite' => 'Lax' // или 'None' при HTTPS
            ]);
        }
    }
});

4. Очистите кеш браузера и куки для сайта.

Проверка результата после внедрения

• Откройте консоль браузера и проверьте, что cookie WooCommerce имеют атрибут SameSite согласно настройке.
• Сымитируйте оплату через тестовый платежный шлюз. Заказ должен корректно завершаться без дублирующихся оплат.
• Проверьте логи WooCommerce и платежной системы на отсутствие повторных попыток оплаты.

Частые ошибки и их исправление

• Ошибка: Использование SameSite=None без HTTPS.
  Исправление: Перейти на HTTPS или изменить атрибут на Lax.
• Ошибка: Перезапись cookie без атрибута SameSite другими плагинами.
  Исправление: Отключить конфликтующие плагины или отследить через дебаггер заголовков.
• Ошибка: Несвоевременный вызов session_start() после отправки заголовков.
  Исправление: Вызывать в init с приоритетом 1 или ранее.

Практические советы по безопасности и производительности

• Всегда используйте HTTPS — это обязательное требование для SameSite=None.
• Минимизируйте время жизни сессионных cookie, чтобы снизить риск перехвата.
• Отключайте ненужные плагины, которые могут влиять на сессии и cookie.
• Регулярно проверяйте логи платежей, чтобы обнаружить аномалии с повторными оплатами.