WooCommerce: отладка проблем с оплатой через Сбербанк Мерчант

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

Если после подключения платежного шлюза Сбербанк Мерчант в WooCommerce платежи не проходят или транзакции застревают в статусе «Ожидание оплаты», важно провести системную диагностику. Основные симптомы:

• Покупатель нажимает кнопку оплаты, но происходит перенаправление на пустую страницу или с ошибкой.
• Заказы в админке WooCommerce остаются в статусе «Ожидание оплаты» без обновления.
• Платежи отображаются в личном кабинете банка, но WooCommerce не получает подтверждение.
• Ошибки в логах плагина или сервера, например, 403, 500, timeout.

Проверка ошибок и логов

Для начала включите в настройках плагина Сбербанк Мерчант режим отладки (debug). Проверьте логи ошибок в WooCommerce (WooCommerce → Статус → Логи) и в системных логах сервера (error_log). Особое внимание уделите ошибкам, связанным с callback URL и SSL-сертификатом.

Пошаговое решение проблем с оплатой через Сбербанк Мерчант

Шаг 1. Проверка callback URL и SSL

Убедитесь, что в личном кабинете Сбербанка в настройках мерчанта указан правильный callback URL. Он должен совпадать с адресом, который принимает уведомления о платеже на вашем сайте, обычно https://вашдомен.ru/?wc-api=WC_Sberbank_Merchant или аналогичный, в зависимости от плагина.

SSL-сертификат должен быть валидным и не иметь предупреждений. Проблемы с HTTPS — частая причина сбоев.

Шаг 2. Настройка плагина WooCommerce для Сбербанк Мерчант

Проверьте, что в настройках плагина заполнены все обязательные поля: идентификатор мерчанта, секретные ключи, тип интеграции (API или Redirect), и выбран правильный режим (тестовый или боевой).

Шаг 3. Разрешение доступа к callback URL

Некоторые плагины безопасности или файлы .htaccess блокируют внешние запросы к callback URL. Проверьте, что URL доступен извне с помощью команды:

curl -I "https://вашдомен.ru/?wc-api=WC_Sberbank_Merchant"

Ответ должен быть 200 OK. Если не так — исправьте правила доступа, исключив callback URL из блокировок.

Шаг 4. Проверка формата данных и подписи

При использовании API Сбербанка убедитесь, что подпись запроса формируется корректно. В плагинах обычно есть встроенный механизм, но при кастомных доработках могут возникать ошибки. Для проверки подписи сравните строку данных, по которой формируется хэш, с документацией Сбербанка.

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

После внесения правок выполните тестовую оплату в тестовом режиме. Важно проверить:

• Переход на страницу оплаты без ошибок.
• Успешное завершение платежа и смена статуса заказа на «Обработан» или «Оплачен».
• Появление записей в логах плагина без ошибок.
• Получение уведомления от Сбербанка и правильную обработку callback.

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

• Неверный callback URL: часто причина в опечатках или отсутствии https. Решение — сверить URL и поправить в кабинете мерчанта.
• Блокировка внешних запросов: плагины безопасности (Wordfence, iThemes Security) или правила .htaccess могут блокировать обработку callback. Решение — добавить исключения для URL оплаты.
• Неправильная настройка секретных ключей: если ключи не совпадают с параметрами в личном кабинете, подпись не пройдет проверку. Решение — перепроверить и обновить ключи.
• Отсутствие SSL или просроченный сертификат: Сбербанк требует HTTPS для callback. Решение — установить валидный сертификат.

Практические советы для надежной работы платежей через Сбербанк Мерчант

• Регулярно обновляйте плагин оплаты и WooCommerce, чтобы избежать несовместимостей.
• Используйте отдельную тестовую среду для проверки интеграции перед выводом в продакшн.
• Включайте логирование платежей в плагине для быстрого обнаружения ошибок.
• Проверяйте, что сервер поддерживает TLS 1.2 и выше — требования Сбербанка к безопасности.
• Автоматизируйте мониторинг статусов платежей с помощью WP Cron и кастомных уведомлений.

Сравнение вариантов решения проблем с оплатой

Пример кода для проверки callback в functions.php

add_action('woocommerce_api_wc_sberbank_merchant', 'handle_sberbank_callback');
function handle_sberbank_callback() {
    $request_body = file_get_contents('php://input');
    // Логируем для отладки
    error_log('Sberbank callback: ' . $request_body);

    $data = json_decode($request_body, true);
    if ($data && isset($data['orderNumber'])) {
        $order_id = intval($data['orderNumber']);
        $order = wc_get_order($order_id);
        if ($order) {
            // Проверяем статус оплаты и меняем статус заказа
            if ($data['paymentStatus'] === 'APPROVED') {
                $order->payment_complete();
                echo 'OK';
            } else {
                $order->update_status('failed');
                echo 'FAILED';
            }
        }
    }
    wp_die();
}

Чек-лист для отладки оплаты через Сбербанк Мерчант

• Проверить и обновить callback URL в кабинете Сбербанка.
• Убедиться в корректности SSL-сертификата.
• Включить отладку в плагине и просмотреть логи.
• Проверить доступность callback URL извне (curl).
• Проверить правильность секретных ключей и параметров.
• Проверить, не блокируется ли callback URL плагинами безопасности.
• Провести тестовый платеж в тестовом режиме.