WooCommerce: устранение проблемы отсутствия подтверждения платежа при оплате картой

Диагностика проблемы отсутствия подтверждения платежа

Проблема отсутствия подтверждения платежа после оплаты картой в WooCommerce возникает, когда заказ не меняет статус на "Обработан" или "Завершён", а клиент не получает уведомление об успешной оплате. Это часто связано с некорректной работой шлюза оплаты, ошибками в вебхуках или неверной настройкой callback URL.

Для диагностики выполните следующие шаги:

• Проверьте журнал платежного шлюза в WooCommerce (WooCommerce > Статус > Журналы) на наличие ошибок.
• Убедитесь, что URL-адресы webhook настроены корректно и доступны извне.
• Проверьте логи сервера на наличие ошибок при обработке callback-запросов.
• Отключите все плагины, кроме WooCommerce и платежного шлюза, чтобы исключить конфликт.

Пошаговое решение проблемы

1. Проверка и настройка webhook URL

Платежные шлюзы отправляют уведомления о статусе платежа на webhook URL. Часто URL указан неверно или заблокирован сервером.

Проверьте в настройках платежного шлюза, что webhook указывает на правильный адрес, например:

https://example.com/?wc-api=payment_gateway_callback

Убедитесь, что этот адрес доступен извне и корректно обрабатывает запросы.

2. Реализация обработчика callback в functions.php

Если используете кастомный шлюз, добавьте обработку callback для статуса платежа:

add_action('woocommerce_api_payment_gateway_callback', 'handle_payment_callback');
function handle_payment_callback() {
    $order_id = $_GET['order_id'];
    $order = wc_get_order($order_id);

    // Проверка валидности запроса и подписи
    if (!valid_callback($_POST)) {
        status_header(400);
        exit;
    }

    if ($_POST['payment_status'] === 'success') {
        $order->payment_complete();
        $order->add_order_note('Платеж успешно подтверждён через callback.');
    } else {
        $order->update_status('failed', 'Платеж не подтверждён.');
    }

    status_header(200);
    exit;
}

function valid_callback($data) {
    // Реализуйте проверку подписи, секретного ключа и т.д.
    return true;
}

3. Проверка SSL и доступности сервера

Платежные системы требуют защищённое соединение HTTPS. Проверьте наличие и корректность SSL-сертификата. Используйте команду:

curl -I https://example.com/?wc-api=payment_gateway_callback

Ответ должен содержать статус HTTP/1.1 200 OK.

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

• Совершите тестовый платеж с использованием тестовой карты платежного шлюза.
• Проверьте изменение статуса заказа в WooCommerce на "Обработан" или "Завершён".
• Убедитесь, что клиент получил уведомление об успешной оплате по e-mail.
• Проверьте логи платежного шлюза и сайта на отсутствие ошибок.

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

• Ошибка 404 или 403 при вызове webhook: Проверьте настройки .htaccess и файервола сервера, разрешите доступ к URL.
• Некорректная валидация подписи: Проверьте алгоритм проверки подписи в callback, используйте официальную документацию платежного шлюза.
• Отсутствие HTTPS: Установите SSL-сертификат и перенаправьте HTTP на HTTPS.
• Конфликты с другими плагинами: Отключите временно все плагины кроме WooCommerce и шлюза, чтобы локализовать проблему.

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

• Используйте nonce и проверку IP-адреса источника для защиты webhook от подделок.
• Логируйте все входящие callback-запросы с деталями для последующего аудита.
• Оптимизируйте код обработчика, чтобы он выполнялся быстро и не блокировал сервер.
• Обновляйте платежный плагин до последней версии для совместимости и безопасности.

Сравнение вариантов реализации callback-обработки