WooCommerce: автоматическое возвращение оплаты при отмене заказа

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

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

Как понять, что возврат не происходит автоматически?

• Заказы меняют статус на «Отменен», но деньги остаются у клиента.
• В админке WooCommerce не создаются запросы на возврат.
• Ручное выполнение возврата занимает много времени и приводит к ошибкам.

Пошаговое решение: автоматизация возврата оплаты при отмене заказа

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

Шаг 1. Добавляем хук на смену статуса заказа

Используем хук woocommerce_order_status_cancelled, который вызывается при изменении статуса заказа на «отменен».

add_action('woocommerce_order_status_cancelled', 'wc_auto_refund_on_cancelled_order', 10, 1);

Шаг 2. Реализация функции возврата оплаты

Внутри функции нужно проверить, что заказ оплачен, и вызвать метод возврата платежа из используемого платежного шлюза. Ниже пример для PayPal Standard, где WooCommerce хранит ID транзакции в метаданных заказа.

function wc_auto_refund_on_cancelled_order($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) {
        error_log('Order not found: ' . $order_id);
        return;
    }

    // Проверяем, оплачен ли заказ
    if ($order->get_status() !== 'cancelled' || !$order->is_paid()) {
        return;
    }

    // Получаем ID транзакции PayPal
    $transaction_id = $order->get_transaction_id();
    if (empty($transaction_id)) {
        error_log('Transaction ID not found for order: ' . $order_id);
        return;
    }

    // Зависит от платежного шлюза: пример для PayPal Standard
    $payment_gateway = wc_get_payment_gateway_by_order($order);
    if ($payment_gateway && method_exists($payment_gateway, 'process_refund')) {
        $amount = $order->get_total();
        $reason = 'Автоматический возврат при отмене заказа';
        $refund = $payment_gateway->process_refund($order_id, $amount, $reason);
        if (is_wp_error($refund)) {
            error_log('Ошибка возврата для заказа ' . $order_id . ': ' . $refund->get_error_message());
        } else {
            error_log('Возврат средств успешно выполнен для заказа ' . $order_id);
        }
    } else {
        error_log('Метод process_refund не найден у платежного шлюза для заказа ' . $order_id);
    }
}

Важно: Для других шлюзов реализация возврата может отличаться. Нужно изучить документацию или исходники плагина платежного шлюза.

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

• Создайте тестовый заказ и оплатите его через выбранный платежный шлюз.
• В админке измените статус заказа на «Отменен».
• Проверьте логи ошибки (error_log), чтобы убедиться, что возврат инициирован.
• Подтвердите, что средства вернулись на счет клиента — это зависит от платежного шлюза и может занять время.
• Проверьте статус возврата в админке WooCommerce, если плагин поддерживает отображение информации о возвратах.

Частые ошибки и способы их устранения

• Ошибка: Отсутствует ID транзакции (get_transaction_id() возвращает пустое значение).
  Решение: Убедитесь, что платежный шлюз записывает ID транзакции в заказ. В некоторых случаях нужно использовать мета-данные _transaction_id или другой ключ.
• Ошибка: Платежный шлюз не поддерживает метод process_refund.
  Решение: Изучите документацию шлюза, возможно, придется использовать их API напрямую через cURL или SDK.
• Ошибка: Возврат инициируется, но средства не возвращаются.
  Решение: Проверьте статусы возврата в личном кабинете платежного шлюза, убедитесь, что параметры и суммы передаются правильно.
• Ошибка: Возврат срабатывает несколько раз.
  Решение: Добавьте проверку, чтобы возврат выполнялся один раз, например, сохраняйте мета-данные с флагом выполненного возврата.

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

• Не храните в коде секретные ключи платежных шлюзов — используйте настройки плагина.
• Логируйте ошибки возврата в отдельный файл или используйте системные логи, чтобы быстро обнаруживать сбои.
• Добавьте проверку nonce и прав пользователя, если вызываете возврат из пользовательского интерфейса.
• Не делайте процесс возврата синхронным при массовом обновлении заказов — используйте очереди (WP-Cron или внешние сервисы) для обработки.
• Регулярно обновляйте плагины платежных шлюзов, чтобы поддерживать совместимость API.

Чек-лист для внедрения автоматического возврата оплаты

1. Проверить, что платежный шлюз поддерживает возврат через API.
2. Добавить хук woocommerce_order_status_cancelled для вызова функции возврата.
3. Реализовать функцию возврата, используя методы платежного шлюза.
4. Добавить логирование ошибок и успешных возвратов.
5. Провести тестирование на тестовом заказе с реальным или тестовым платежом.
6. Убедиться, что возврат не выполняется повторно для одного заказа.
7. Настроить мониторинг логов для оперативного обнаружения проблем.

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