WooCommerce: как отладить проблемы с автоматическим возвратом средств

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

Автоматический возврат средств (refund) — важный функционал для интернет-магазина на WooCommerce. Часто возникают ситуации, когда возврат срабатывает некорректно или вовсе не выполняется, особенно при интеграции с платежными шлюзами или кастомными обработчиками. В первую очередь следует проверить:

• Логи платежного шлюза — поддерживает ли он автоматические возвраты через API.
• Корректность настроек WooCommerce для возвратов (статусы заказов, права пользователя).
• Наличие ошибок в PHP-логе и WooCommerce логах возвратов (WooCommerce > Статус > Логи).
• Правильность реализации кода, вызывающего возврат средств, если используется кастомная автоматизация.

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

1. Проверяем поддержку возвратов платежным шлюзом

Не все платежные шлюзы поддерживают автоматический возврат через API. Например, PayPal и Stripe имеют такую возможность, а некоторые локальные шлюзы — нет. Проверьте документацию вашего шлюза.

2. Актуализируем права пользователя и настройки статусов заказа

Для автоматического возврата функция WooCommerce использует права администратора или пользователя с правами возврата. Убедитесь, что скрипт или пользователь, вызывающий возврат, имеет необходимые права.

3. Используем стандартный хук WooCommerce для автоматического возврата

Для программного запуска возврата можно использовать функцию wc_create_refund(). Пример кода для возврата всей суммы заказа:

function wc_auto_refund_order( $order_id ) {
    $order = wc_get_order( $order_id );

    if ( ! $order ) {
        return new WP_Error( 'invalid_order', 'Заказ не найден' );
    }

    $refund = wc_create_refund( array(
        'amount'         => $order->get_total(),
        'reason'         => 'Автоматический возврат',
        'order_id'       => $order_id,
        'refund_payment' => true, // инициирует возврат через платежный шлюз
    ) );

    if ( is_wp_error( $refund ) ) {
        error_log( 'Ошибка возврата: ' . $refund->get_error_message() );
        return $refund;
    }

    return true;
}

Вызывайте эту функцию из вашего обработчика (например, после изменения статуса заказа).

4. Логируем ошибки и успешные возвраты

Для отладки добавьте логирование:

if ( is_wp_error( $refund ) ) {
    error_log( 'Ошибка возврата заказа #' . $order_id . ': ' . $refund->get_error_message() );
} else {
    error_log( 'Успешный возврат заказа #' . $order_id );
}

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

• Создайте тестовый заказ с оплатой через платежный шлюз, поддерживающий возвраты.
• Вызовите функцию возврата, например через консоль WP-CLI или кастомный скрипт.
• Проверьте логи WooCommerce и серверные логи на наличие ошибок.
• Проверьте статус заказа и отображение возврата в админке WooCommerce.
• Убедитесь, что деньги действительно вернулись на счет покупателя (на стороне платежного шлюза).

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

• Ошибка: "Refund failed" или возврат не создаётся
  Причина: платежный шлюз не поддерживает возвраты через API или неверные настройки API.
  Решение: проверьте документацию шлюза, обновите ключи API, убедитесь, что в настройках включена возможность возврата.
• Возврат создаётся, но деньги не возвращаются покупателю
  Причина: параметр refund_payment в wc_create_refund() не установлен или платежный шлюз не завершает операцию.
  Решение: проверьте параметр refund_payment и логи шлюза, возможно, нужны дополнительные настройки.
• Проблемы с правами пользователя или скрипта
  Причина: функция вызывается от имени пользователя без прав на возвраты.
  Решение: используйте администратора или добавьте необходимые права для пользователя/скрипта.
• Ошибки синхронизации статусов заказа после возврата
  Причина: отсутствует обновление статуса заказа после возврата.
  Решение: вручную обновляйте статус заказа, например, на "refunded" после успешного возврата в коде.

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

• Всегда проверяйте возвраты в тестовой среде перед запуском на продакшене.
• Ограничьте выполнение автоматических возвратов только проверенными сценариями, чтобы избежать злоупотреблений.
• Логируйте все операции возврата с указанием ID заказа и причины для последующего аудита.
• Не храните в коде открытые ключи API — используйте защищённые переменные среды или настройки WooCommerce.
• Оптимизируйте вызовы API платежного шлюза, избегайте повторных запросов на возврат одного заказа.

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