WooCommerce: автоматическое изменение статуса заказа при проблемах с платежной системой

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

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

• Проверку логов платежных шлюзов (например, PayPal, Stripe, Яндекс.Касса).
• Мониторинг webhook-событий от платежных систем.
• Отслеживание статусов заказов в WooCommerce через панель администратора.

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

Пошаговое решение: автоматическое изменение статуса заказа при ошибке оплаты

1. Подключение хука для обработки webhook от платежной системы

Большинство современных платежных систем поддерживают webhook для уведомления об изменении статуса транзакции. В WooCommerce можно слушать эти уведомления и менять статус заказа программно.

2. Пример кода для изменения статуса при ошибке оплаты

add_action('woocommerce_order_status_failed', 'custom_handle_failed_payment', 10, 1);
function custom_handle_failed_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Логика дополнительной проверки ошибок
    // Например, проверка мета-данных платежа
    $payment_error_code = $order->get_meta('_payment_error_code');

    if ($payment_error_code) {
        // Устанавливаем статус, например, 'on-hold' для ручной проверки
        $order->update_status('on-hold', 'Заказ переведен в ожидание из-за ошибки платежа: ' . $payment_error_code);
    }
}

Этот код слушает событие «failed» заказа и меняет статус на «on-hold», если в мета-данных есть код ошибки.

3. Обработка webhook вручную через API

Если платежная система не интегрирована напрямую, можно создать endpoint для webhook и менять статус заказа вручную:

add_action('rest_api_init', function () {
    register_rest_route('custom/v1', '/payment-webhook', array(
        'methods' => 'POST',
        'callback' => 'custom_payment_webhook_handler',
        'permission_callback' => '__return_true',
    ));
});

function custom_payment_webhook_handler(WP_REST_Request $request) {
    $data = $request->get_json_params();
    $order_id = isset($data['order_id']) ? intval($data['order_id']) : 0;
    $payment_status = isset($data['status']) ? sanitize_text_field($data['status']) : '';

    if (!$order_id || !$payment_status) {
        return new WP_REST_Response('Invalid data', 400);
    }

    $order = wc_get_order($order_id);
    if (!$order) {
        return new WP_REST_Response('Order not found', 404);
    }

    if ($payment_status === 'failed') {
        $order->update_status('cancelled', 'Оплата не прошла, заказ отменен автоматически');
    }

    return new WP_REST_Response('OK', 200);
}

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

После добавления кода выполните следующие проверки:

• Создайте тестовый заказ и симулируйте ошибку оплаты (например, через тестовый режим платежного шлюза).
• Убедитесь, что статус заказа автоматически меняется на указанный (например, «on-hold» или «cancelled»).
• Проверьте логи WooCommerce и серверные логи на предмет ошибок.
• Отправьте webhook на созданный endpoint и убедитесь, что обработчик меняет статус.

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

• Ошибка: Статус заказа не меняется. Причина: хук подключен неправильно или конфликт с другим плагином. Проверьте правильность подключения и деактивируйте конфликтующие плагины.
• Ошибка: Webhook не вызывается. Причина: неверный URL webhook или проблемы с SSL. Проверьте правильность URL и наличие сертификата.
• Ошибка: Недостаточно прав для API. Проверьте, что permission_callback возвращает true или реализована авторизация.
• Ошибка: Данные webhook не соответствуют ожиданиям. Логируйте входящие запросы для анализа формата данных.

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

• Добавьте в webhook обработчик проверку подписи от платежной системы, чтобы исключить подделку запросов.
• Используйте транзакции и проверки целостности данных при изменении статусов заказа.
• Логируйте все изменения статусов с поясняющими комментариями для последующего аудита.
• Оптимизируйте код, чтобы не вызывать тяжелые операции при каждом webhook (например, кэшируйте результаты проверок).

Сравнение способов автоматического изменения статуса заказа