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

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

Многие магазины на WooCommerce сталкиваются с необходимостью автоматического возврата средств клиенту при отмене заказа. Стандартный функционал WooCommerce не предусматривает автоматический возврат, и требуется дополнительная реализация. Проблемы чаще всего возникают из-за отсутствия интеграции с платежным шлюзом или неправильного использования хуков.

Проверить, срабатывает ли возврат, можно в админке WooCommerce на странице заказа: если после отмены статус заказа меняется, но возврат оплаты не инициируется, значит автоматизация не настроена.

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

1. Определяем момент отмены заказа

Для запуска возврата нужно отследить изменение статуса заказа на cancelled. Используем хук woocommerce_order_status_cancelled:

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

2. Реализуем функцию автоматического возврата

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

function auto_refund_on_cancelled_order($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Проверяем, что заказ оплачен
    if ($order->get_payment_method() !== 'paypal') return; // пример для PayPal
    if (!$order->is_paid()) return;

    // Проверяем, что возврат еще не сделан
    if ($order->get_meta('_auto_refunded')) return;

    $refund_amount = $order->get_total();
    $refund_reason = 'Автоматический возврат при отмене заказа';

    // Создаем возврат
    $refund = wc_create_refund(array(
        'amount'     => $refund_amount,
        'reason'     => $refund_reason,
        'order_id'   => $order_id,
        'refund_payment' => true
    ));

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

    // Отмечаем, что возврат сделан
    $order->update_meta_data('_auto_refunded', true);
    $order->save();
}

3. Тестируем на песочнице платежного шлюза

Перед использованием на реальном магазине обязательно убедитесь, что у вас настроена тестовая среда платежного шлюза (например, PayPal Sandbox). Создайте тестовый заказ, оплатите его, затем отмените и проверьте, что возврат инициируется автоматически.

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

• Создайте заказ и оплатите его через платежный шлюз, настроенный для тестирования.
• В админке WooCommerce измените статус заказа на "Отменен".
• Проверьте логи WooCommerce (wp-content/debug.log) на предмет ошибок.
• В заказе должен появиться возврат (Refund) с суммой оплаты.
• Проверьте историю транзакций в платежном шлюзе — возврат должен быть отображен.

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

• Отсутствие возврата при отмене: Проверьте, что используется правильный хук woocommerce_order_status_cancelled и что платежный метод поддерживает автоматические возвраты.
• Возврат создается, но не проходит в платежном шлюзе: Убедитесь, что у вас корректно настроен API ключ и разрешены операции возврата в платежном шлюзе.
• Множественные возвраты на один заказ: Добавьте мета-флаг _auto_refunded для предотвращения повторных возвратов.
• Ошибки в логах: Включите режим отладки WP_DEBUG и WP_DEBUG_LOG, чтобы получить подробности ошибок.

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

• Безопасность API: Никогда не храните ключи API в публичных местах. Используйте константы в wp-config.php или защищенные переменные окружения.
• Очистка метаданных: После успешного возврата удаляйте или обновляйте мета-данные заказа, чтобы не накапливались лишние данные.
• Логирование: Добавьте логирование ошибок возврата, чтобы оперативно реагировать на проблемы.
• Ограничение по статусам: Автоматический возврат имеет смысл только для предоплаченных заказов — избегайте возврата для заказов с другими статусами.

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