WooCommerce: установка и настройка отложенной оплаты

Что такое отложенная оплата в WooCommerce и зачем она нужна

Отложенная оплата — это возможность позволить клиенту оформить заказ, но оплатить его позже, например, после подтверждения менеджером или по договоренности. В стандартном WooCommerce нет встроенной поддержки этой функции, поэтому чаще всего ее реализуют через специальные плагины или пользовательский код. Это удобно для B2B-продаж, магазинов с индивидуальными условиями оплаты или для предзаказов.

Диагностика проблемы: почему стандартный WooCommerce не подходит для отложенной оплаты

WooCommerce по умолчанию предлагает только моментальную оплату или оплату при получении. Если попытаться использовать статус заказа "обработка" без оплаты, клиенту все равно нужно проходить оплату через выбранный метод. Без доработок нельзя просто «отложить» оплату, не нарушая логику магазина и уведомления.

Основные ограничения без отложенной оплаты:

• Отсутствие отдельного статуса заказа для неоплаченных заказов с последующей оплатой.
• Невозможность отключения требования оплаты на этапе оформления.
• Неправильная обработка уведомлений и статусов заказов.

Пошаговое решение: как реализовать отложенную оплату в WooCommerce

1. Установка плагина для отложенной оплаты

Рекомендуется использовать бесплатный или коммерческий плагин, например WooCommerce Order Delayed Payment или аналогичные. Если хочется избежать плагинов, можно реализовать кастомный код (см. ниже).

2. Добавление нового статуса заказа «Ожидает оплату»

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

add_action('init', 'register_custom_order_status');
function register_custom_order_status() {
    register_post_status('wc-awaiting-payment', array(
        'label' => 'Ожидает оплату',
        'public' => true,
        'exclude_from_search' => false,
        'show_in_admin_all_list' => true,
        'show_in_admin_status_list' => true,
        'label_count' => _n_noop('Ожидает оплату <span class="count">(%s)</span>', 'Ожидает оплату <span class="count">(%s)</span>'),
    ));
}

add_filter('wc_order_statuses', 'add_custom_order_status_to_list');
function add_custom_order_status_to_list($order_statuses) {
    $new_statuses = array();
    foreach ($order_statuses as $key => $status) {
        $new_statuses[$key] = $status;
        if ('wc-pending' === $key) {
            $new_statuses['wc-awaiting-payment'] = 'Ожидает оплату';
        }
    }
    return $new_statuses;
}

3. Отключение обязательной оплаты на этапе оформления для выбранных методов

Добавим проверку, которая позволит пропускать оплату при выборе отложенного метода, например «Оплата при получении» с доработкой.

add_filter('woocommerce_cart_needs_payment', 'disable_payment_for_delayed_orders', 10, 2);
function disable_payment_for_delayed_orders($needs_payment, $cart) {
    if (isset($_POST['payment_method']) && $_POST['payment_method'] === 'cod') { // cod - оплата при получении
        return false; // Отключаем требование оплаты
    }
    return $needs_payment;
}

4. Автоматический перевод заказов в статус «Ожидает оплату» после оформления

add_action('woocommerce_thankyou', 'set_order_status_awaiting_payment');
function set_order_status_awaiting_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if ($order->get_payment_method() === 'cod') {
        $order->update_status('awaiting-payment');
    }
}

5. Добавление кнопки «Оплатить заказ» на страницу личного кабинета для неоплаченных заказов

Для удобства клиента добавим ссылку на оплату, если заказ в статусе «Ожидает оплату».

add_action('woocommerce_order_details_after_order_table', 'add_pay_order_button_for_awaiting_payment');
function add_pay_order_button_for_awaiting_payment($order) {
    if ($order->has_status('awaiting-payment')) {
        $pay_url = $order->get_checkout_payment_url();
        echo '<p><a href="' . esc_url($pay_url) . '" class="button">Оплатить заказ</a></p>';
    }
}

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

• Оформить заказ с выбранным методом оплаты «Оплата при получении».
• После оформления заказа проверить, что статус изменился на «Ожидает оплату».
• Перейти в личный кабинет пользователя, убедиться, что появилась кнопка «Оплатить заказ».
• Нажать на кнопку, перейти к странице оплаты и оплатить заказ обычным способом.
• Проверить, что статус заказа изменился на «Обработка» или «Завершён» после оплаты.

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

• Ошибка: Заказ не меняет статус на «Ожидает оплату».
  Причина: Неправильный идентификатор метода оплаты или код не подключен.
  Решение: Проверьте правильность проверки $order->get_payment_method() и подключение к хуку woocommerce_thankyou.
• Ошибка: Кнопка оплаты не отображается в личном кабинете.
  Причина: Неверный статус заказа или функция не добавлена в нужный хук.
  Решение: Проверьте, что статус заказа действительно «awaiting-payment» и функция подключена к woocommerce_order_details_after_order_table.
• Ошибка: Оплата всё равно требуется на этапе оформления.
  Причина: Фильтр отключения оплаты не срабатывает для выбранного метода.
  Решение: Убедитесь, что в $_POST['payment_method'] приходит корректное значение, либо используйте другой способ определения метода оплаты.

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

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

Сравнение вариантов реализации отложенной оплаты