KosTeams оплата через Яндекс Пей и Яндекс Сплит в WooCommerce

Принимайте оплату через Яндекс Пей, Яндекс Сплит или их комбинацию. Увеличьте конверсию за счет гибких способов оплаты с плагином от KosTeams.

Описание

Плагин добавляет в ваш магазин на WooCommerce популярные способы оплаты от Яндекса:
– Яндекс Пей: мгновенная оплата картой без ввода данных.
– Яндекс Сплит: рассрочка без переплат до 6 месяцев.
– Комбинированная оплата: часть суммы картой, остаток — в рассрочку.

Совместимость с современными технологиями

• Полная поддержка WooCommerce Block Editor – плагин работает как с классическим, так и с блочным чекаутом
• Gutenberg-совместимость – интеграция с современными темами WordPress
• React компоненты – современная архитектура для быстрой работы

Для расширенных возможностей (бейджи рассрочки, виджеты в корзине и каталоге) доступна Pro-версия плагина.

Важная информация о фискализации

Обратите внимание: При использовании Яндекс Pay и Яндекс Сплит необходимо соблюдать требования российского законодательства по фискализации платежей.

Требования 54-ФЗ

Согласно Федеральному закону “О применении контрольно-кассовой техники” (54-ФЗ):
– При любых формах безналичных расчетов необходимо выдавать фискальные чеки
– Яндекс Pay и Яндекс Сплит не отправляют фискальные чеки автоматически
– Ответственность за соблюдение требований фискализации лежит на продавце

Возможные решения

Для обеспечения соответствия 54-ФЗ рассмотрите следующие варианты:
– Интеграция с онлайн-кассами (АТОЛ, Эвотор, ОФД и др.)
– Использование специализированных плагинов для автоматической отправки чеков
– Настройка API интеграции с вашим поставщиком фискальных услуг
– Консультация с сертифицированными интеграторами ККТ

Штрафы за нарушение

• Для индивидуальных предпринимателей: от 10 000 рублей за каждый случай
• Для юридических лиц: от 30 000 рублей за каждое нарушение
• Возможна приостановка деятельности на срок до 90 суток

Рекомендация: Обязательно настройте фискализацию до начала приема платежей через Яндекс Pay. За подробной консультацией обратитесь к вашему бухгалтеру или поставщику услуг онлайн-касс.

Установка

1. Установите плагин через административную панель WordPress.
2. Активируйте его в разделе «Плагины».
3. Перейдите в WooCommerce → Настройки → Платежи → Яндекс Пей и Яндекс Сплит.
4. Введите Merchant ID и API-ключ (получаются через партнерский договор с Яндексом).
5. Включите нужные методы оплаты и сохраните изменения.
6. Важно: Настройте фискализацию платежей в соответствии с 54-ФЗ.

Часто задаваемые вопросы

Почему не проходит оплата?

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

Нужен ли договор с Яндексом?

Да, для работы плагина требуется подключение к Яндекс Пей через партнерский договор.

Почему не отображается метод оплаты на странице оформления заказа (Checkout)?

Метод оплаты будет отображаться только в том случае, если он включён в настройках WooCommerce и соответствует условиям (например, валюте, стране или способу доставки).
Проверьте:
1. Включён ли метод в разделе WooCommerce → Настройки → Платежи.
2. Правильно ли настроены условия доступности метода.
3. Нет ли конфликтов с другими плагинами или темой.

Как работает Сплит для покупателя?

Покупатель оформляет заказ, вносит первый платёж и получает товар сразу. Остальные платежи списываются по расписанию. Магазин получает всю сумму сразу, как при обычной покупке.

Как добавить бейджи рассрочки в карточке товара?

Эта функция доступна в Pro-версии, которая позволяет настраивать дизайн, позиционирование и условия отображения элементов.

Почему виджеты не отображаются в корзине?

Интеграция с корзиной и оформлением заказа поддерживается в Pro-версии. Бесплатная версия фокусируется на базовой реализации платежей.

Как проверить работу в тестовом режиме?

Используйте тестовые данные от Яндекса. Реальные деньги не будут списаны.

Как обеспечить фискализацию платежей?

Яндекс Pay не отправляет фискальные чеки автоматически. Рекомендуемые решения:

Готовое решение (рекомендуется):
– KosTeams АТОЛ Чеки – специализированный плагин, который автоматически отправляет чеки для всех платежей Яндекс Pay и Сплит

Альтернативные варианты:
– Подключить онлайн-кассу (АТОЛ, Эвотор и др.) и настроить API интеграцию
– Использовать другие плагины для фискализации
– Разработать собственную интеграцию с ОФД
– Проконсультироваться с вашим поставщиком ККТ услуг

Какие штрафы за отсутствие фискализации?

Согласно 54-ФЗ, за неприменение ККТ предусмотрены штрафы от 10 000 рублей для ИП и от 30 000 рублей для ООО за каждый случай нарушения.

Возможности версий

Бесплатная версия включает:
– Поддержка Яндекс Пей и Яндекс Сплит
– Комбинированная оплата (карта + рассрочка)
– Настройка через интерфейс WooCommerce
– Совместимость с классическим и блочным редактором Gutenberg

Pro-версия добавляет:
– Бейджи рассрочки/кэшбэка в карточках товаров
– Бейджи рассрочки/кэшбэка в каталоге товара
– Виджеты оплаты в корзине и каталоге
– Кнопка оплаты от Яндекса на странице оформления заказа
– 20+ вариантов позиционирования элементов

Рекомендуемые дополнения

Для обеспечения полного соответствия требованиям российского законодательства и расширения функциональности рекомендуются следующие решения:

Фискализация платежей (обязательно для соблюдения 54-ФЗ)

KosTeams АТОЛ Чеки – Специализированный плагин для автоматической фискализации платежей через Яндекс Pay и Яндекс Сплит.

Основные возможности:
– Автоматическая отправка фискальных чеков в АТОЛ Онлайн при каждом платеже
– Полная поддержка АТОЛ API v4 и v5
– Автоматическое определение платежей через Яндекс Пей и Сплит
– Поддержка HPOS (High-Performance Order Storage)
– Автоматические чеки возврата при отмене заказов
– Мониторинг статусов фискализации в реальном времени
– Детальное логирование для диагностики проблем

Почему именно этот плагин:
– Разработан специально для интеграции с Яндекс платежными системами
– Автоматически определяет платежи, которые требуют фискализации
– Полностью соответствует требованиям 54-ФЗ
– Тестируется совместно с данным плагином

Альтернативные решения фискализации

• Другие плагины интеграции с АТОЛ Онлайн
• Решения для интеграции с Эвотор
• Модули подключения к другим ОФД
• API интеграции с вашим поставщиком ККТ

Улучшение конверсии

KosTeams оплата с Яндекс Пей и Яндекс Сплит в WooCommerce Pro – Расширенная версия текущего плагина с дополнительными возможностями:
– Бейджи рассрочки/кэшбэка в карточках и каталоге товаров
– Виджеты оплаты в корзине и на страницах товаров
– 20+ вариантов позиционирования элементов
– Расширенные настройки дизайна и поведения

Важно: Независимо от выбранного решения для фискализации, его настройка обязательна до начала приема платежей через Яндекс Pay для соблюдения требований 54-ФЗ.

Ссылки

• Документация по настройке
• Купить Pro-версию
• Информация о 54-ФЗ и фискализации

Лицензия

Этот плагин распространяется под лицензией GPLv2. Расширенные функции доступны в Pro-версии.

Поддержка и безопасность

Безопасность платежей

• Все транзакции обрабатываются через защищенные серверы Яндекса
• Данные карт не сохраняются на вашем сайте
• Соответствие стандартам PCI DSS

Соответствие законодательству

• Плагин обеспечивает техническую интеграцию с платежными системами
• Соблюдение требований фискализации (54-ФЗ) требует дополнительных решений
• Рекомендуется консультация с юристами и бухгалтерами

Получение поддержки

• Техническая поддержка через официальные каналы
• Документация и FAQ на сайте разработчика
• Сообщество пользователей для обмена опытом

2.0.4 (2025-11-11)

КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Учет НДС при формировании платежа

ПРОБЛЕМА:
* При включенном НДС в WooCommerce возникало расхождение сумм:
– Сумма заказа в WooCommerce (с НДС): например, 1200 руб
– Сумма передаваемая в Yandex Pay API (без НДС): например, 1000 руб
– Результат: ОШИБКА – платеж не создавался из-за несоответствия сумм

ПРИЧИНА:
* Метод $item->get_total() возвращает сумму БЕЗ налогов
* Метод $order->get_total() возвращает сумму С налогами
* При расчете calculated_total налоги не учитывались, что приводило к расхождению с woocommerce_total

ИСПРАВЛЕНО в файле includes/class-gateway.php:

1. Товары (строка 794):

   • БЫЛО: $line_total = round((float)$item->get_total(), 2);
   • СТАЛО: $line_total = round((float)$item->get_total() + (float)$item->get_total_tax(), 2);

2. Доставка (строка 820):

   • БЫЛО: $shipping_cost = round((float)$shipping_item->get_total(), 2);
   • СТАЛО: $shipping_cost = round((float)$shipping_item->get_total() + (float)$shipping_item->get_total_tax(), 2);

3. Дополнительные сборы (строка 836):

   • БЫЛО: $fee_amount = round((float)$fee_item->get_total(), 2);
   • СТАЛО: $fee_amount = round((float)$fee_item->get_total() + (float)$fee_item->get_total_tax(), 2);

РЕЗУЛЬТАТ:
* Теперь в Yandex Pay API передается полная сумма С учетом НДС
* Сумма заказа в WooCommerce = Сумма в Yandex Pay (100% совпадение)
* Нет расхождений между личным кабинетом и платежной системой
* Покупатель оплачивает правильную сумму, которую видит в корзине

ВАЖНО: Это критическое исправление для всех магазинов, использующих налоги/НДС в WooCommerce. Рекомендуется обновиться немедленно.

2.0.3 (2025-10-27)

КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Точность расчета сумм
* Полностью переписана логика расчета данных для передачи в Яндекс API
* Устранена проблема расхождения сумм между WooCommerce и данными, отправляемыми в Яндекс
* Теперь используются нативные методы WooCommerce для получения итоговых сумм товаров

Исправлено:
– БЫЛА ПРОБЛЕМА: Плагин вручную рассчитывал и распределял скидки по всем товарам пропорционально, что приводило к неправильному распределению (купоны применялись ко всем товарам, даже если были настроены только на определенные товары)
– ИСПРАВЛЕНО: Теперь используется $item->get_total() — WooCommerce сам правильно рассчитывает итоговую сумму с учетом всех скидок

• БЫЛА ПРОБЛЕМА: Товары с количеством > 1 разбивались на отдельные позиции с quantity = 1, что приводило к проблемам с округлением

• ИСПРАВЛЕНО: Товары передаются с реальным количеством

• БЫЛА ПРОБЛЕМА: При несовпадении итоговой суммы, последний товар корректировался, что маскировало ошибки в логике

• ИСПРАВЛЕНО: Корректировки больше нет, суммы точно совпадают

• БЫЛА ПРОБЛЕМА: Передавались лишние поля (unitPrice, discountedUnitPrice, subtotal), которые не нужны для Яндекс Сплит

• ИСПРАВЛЕНО: Передается только total с точной итоговой суммой

Результат:
* Данные в Яндекс = Данные в WooCommerce (100% совпадение)
* Код сократился с ~270 строк до ~70 строк (упрощение в 4 раза)
* Нет ручных расчетов и корректировок
* Все скидки (купоны, промокоды, программы лояльности) применяются правильно

Техническое:
* Упрощена структура данных cart.items[]:
– Обязательные поля: productId, title, quantity.count, total
– Опциональные поля: description
– Удалены: unitPrice, discountedUnitPrice, subtotal (не требуются API)
* Удален блок расчета бонусной скидки (строки 782-817)
* Удалена логика распределения скидок (строки 826-877)
* Удалена логика разбиения товаров (строки 898-937)
* Удалена корректировка последнего товара (строки 1023-1051)

2.0.2 (2025-10-09)

Исправления безопасности:
– Описания товаров теперь очищаются от HTML-тегов перед отправкой во внешние системы

2.0.1 (2025-09-30)

ИСПРАВЛЕНИЯ
* Исправлена критическая ошибка инициализации блоков в контексте WP Cron
* Устранена ошибка “Call to a member function get_cart_contents() on null” при выполнении cron задач
* Исправлена ошибка “Call to a member function get_available_payment_gateways() on null”
* Добавлена отложенная инициализация (lazy loading) для платежных шлюзов в блочном редакторе
* Улучшена совместимость с плагинами, фильтрующими доступные способы оплаты

ТЕХНИЧЕСКОЕ
* Реализована защита от преждевременной инициализации объектов WooCommerce
* Изменен метод получения шлюзов: используется payment_gateways() вместо get_available_payment_gateways()
* Добавлены проверки существования объектов WC() и WC()->payment_gateways перед обращением
* Метод initialize() больше не вызывает фильтры WooCommerce при первичной загрузке

2.0.0 (2025-09-28)

ГЛАВНОЕ ОБНОВЛЕНИЕ
* Полная поддержка WooCommerce Block Editor (блочного редактора)
* Совместимость с современными темами WordPress (Gutenberg блоки)
* Автоматическая регистрация Яндекс Пей и Yandex Split в блочной корзине и чекауте
* Поддержка иконок и описаний платежных методов в блочном интерфейсе
* Современная архитектура с поддержкой React компонентов
* Build процесс для JavaScript файлов (webpack, babel)
* Плагин полностью реструктуризирован: теперь он одинаково стабильно работает и с классическим, и с блочным чекаутом
* Добавлена поддержка возвратов через Яндекс API

МАКСИМАЛЬНАЯ ОПТИМИЗАЦИЯ БД
* Устранено последнее предупреждение о meta_key запросах
* Заменены все запросы с meta_key на глобальную функцию delete_metadata()
* Максимально эффективное удаление метаданных при деинсталляции

ОПТИМИЗАЦИЯ ПРОИЗВОДИТЕЛЬНОСТИ
* Устранено предупреждение о медленном meta_query запросе
* Использование fields => ‘ids’ для получения только ID заказов
* Прямое удаление метаданных через delete_post_meta()

РЕЗУЛЬТАТ
* Значительно улучшена производительность при удалении плагина
* Плагин полностью готов для WordPress.org, пройдены все проверки Plugin Check

ИСПРАВЛЕНИЯ НАЗВАНИЙ
* Унифицированы названия платежных сервисов во всем плагине
* Все “Яндекс.Сплит” заменены на “Яндекс Сплит” (убрана точка)
* Все “Yandex Pay”, “Яндекс Pay”, “Яндекс.Пэй”, “Яндекс Пэй” заменены на “Яндекс Пей”

РЕЗУЛЬТАТ
* Единообразное написание названий
* Улучшенный пользовательский опыт
* Оптимизированный размер плагина

ВОЗВРАТЫ
* Исправлена логика проверки доступной суммы для возврата
* Поддержка повторной отправки существующих возвратов в Яндекс API
* Устранено дублирование WooCommerce refunds при API ошибках
* Добавлено детальное логирование сумм и статусов возвратов

ПОЛЬЗОВАТЕЛЬСКИЙ ОПЫТ
* Замена HTML-тегов на простой текст в сообщениях об ошибках
* Понятные инструкции при отсутствии настроек (Merchant ID, API ключ)
* Проверка формата Merchant ID (UUID) с информативными сообщениями

1.0.13

• Дата: 2025-08-23
• Мелкие доработки

1.0.12

• Дата: 2025-08-03
• КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Устранена ошибка ORDER_AMOUNT_MISMATCH при создании платежей
• Исправлено: Точность расчета сумм с учетом скидок и округлений
• Исправлено: Погрешности в распределении скидок по товарам
• Улучшено: Алгоритм коррекции итоговых сумм для соответствия требованиям API Яндекса
• Улучшено: Точность математических операций с денежными суммами
• Добавлено: Автоматическая коррекция погрешностей округления в последнем товаре корзины
• Добавлено: Дополнительное логирование для отладки расчетов сумм
• Техническое: Соответствие WordPress Coding Standards для интернационализации
• Техническое: Добавлены комментарии переводчика для всех локализуемых строк
• Техническое: Упорядочены плейсхолдеры в переводимых строках (%1$s, %2$s)

Детали исправления ошибки ORDER_AMOUNT_MISMATCH

Ошибка возникала из-за несоответствия формулы: cart_total = items_sum - discounts_sum
* Добавлено точное округление на всех этапах расчетов (round с 2 знаками)
* Реализована проверка соответствия calculated_total с woocommerce_total
* При расхождении ≥0.01 выполняется автоматическая коррекция последнего товара
* Улучшено распределение остатков скидок между товарами
* Добавлена финальная валидация всех сумм перед отправкой в API

Техническое описание

• Все денежные операции теперь выполняются с round($value, 2)
• Добавлена проверка abs($calculated_total - $woocommerce_total) >= 0.01
• Реализована коррекция через adjustment последнего товара в корзине
• Улучшено логирование с выводом всех промежуточных сумм для отладки
• Приведение к стандартам WordPress для корректной локализации

1.0.11

• Дата: 2025-07-20
• Добавлено: Защита от изменения статуса заказов, оплаченных другими платежными системами
• Добавлено: Интеллектуальная обработка вебхуков с учетом способа оплаты
• Улучшено: Логика обработки статусов заказов для предотвращения конфликтов между платежными системами
• Улучшено: Обработка легитимных операций отмены/возврата для заказов Яндекс
• Исправлено: Проблема с отменой оплаченных заказов при получении вебхука от Яндекс после оплаты другим способом

Защита заказов

• Если заказ был оплачен через другую платежную систему, вебхуки от Яндекс больше не будут менять его статус
• Заказы, оплаченные через Яндекс, корректно обрабатывают операции отмены и возврата из личного кабинета Яндекс
• Добавлены информативные заметки к заказам при попытках изменения статуса

Техническое описание

• Метод process_order_status_from_webhook теперь проверяет способ оплаты заказа перед применением изменений
• Добавлена проверка $is_yandex_payment для определения источника оплаты
• Улучшено логирование для отслеживания всех попыток изменения статусов

1.0.10

• Дата: 2025-06-17
• Добавлено: Расширенная обработка вебхуков Яндекс Пей
• Добавлено: Гибкая система маппинга статусов платежей
• Добавлено: Кастомные фильтры для разработчиков
• Улучшено: Рефакторинг обработки вебхуков для повышения надежности
• Улучшено: Логирование операций с платежами
• Улучшено: Безопасность обработки входящих запросов

Фильтры для разработчиков

1. yandex_pay_webhook_status_map
   Изменяет соответствие статусов Яндекс → WooCommerce
   Параметры:

– $status_map (array) – Текущий маппинг статусов
– $order (WC_Order) – Объект заказа
– $payment_status (string) – Статус от Яндекс

Пример:
add_filter(‘yandex_pay_webhook_status_map’, function($status_map, $order, $payment_status) {
$status_map[‘CAPTURED’] = ‘completed’;
return $status_map;
}, 10, 3);

1. yandex_pay_before_process_status
   Изменяет статус перед применением к заказу
   Параметры:

– $new_status (string) – Планируемый статус
– $payment_status (string) – Статус от Яндекс
– $order (WC_Order) – Объект заказа

1. yandex_pay_handle_webhook_status
   Полная кастомная обработка статуса (возврат true отменяет стандартную обработку)
   Параметры:

– $handled (bool) – Флаг обработки
– $payment_status (string) – Статус от Яндекс
– $order (WC_Order) – Объект заказа

1. yandex_pay_status_change_note
   Изменяет заметку при смене статуса заказа
   Параметры:

– $note (string) – Текст заметки
– $order (WC_Order) – Объект заказа
– $old_status (string) – Старый статус
– $new_status (string) – Новый статус

1. yandex_pay_partial_refund_note
   Изменяет заметку для частичного возврата
   Параметры:

– $note (string) – Текст заметки
– $order (WC_Order) – Объект заказа

Улучшения безопасности

• Усилена валидация входящих данных
• Улучшена обработка ошибок декодирования

Исправлено

• Проблемы с обработкой статуса PARTIALLY_REFUNDED

1.0.9

• В платежном шлюзе Яндекс Сплит реализована динамическая смена иконки в зависимости от выбранного способа оплаты
• При выборе “Сплит” отображается стандартная иконка Сплита
• При выборе “Карта + Сплит” отображается комбинированная иконка

1.0.8

Улучшено распределение скидок

• Все типы скидок (купоны, бонусы, отрицательные сборы) суммируются в общую сумму скидки
• Скидки распределяются пропорционально по товарам
• Остаток скидки добавляется к последнему товару для точного распределения

Улучшено формирование корзины

• Для товаров с количеством > 1 создаются отдельные позиции
• Скидка равномерно распределяется между единицами товара
• Скидки применяются только к товарам (не к доставке и сборам)

1.0.7

• Реализовано разделение стилей
• Мелки исправления
• Улучшена документация

1.0.6

Основные изменения:
– Добавлены отдельные платежные шлюзы:
• Яндекс Сплит — оплата частями
• Яндекс Пей — классическая оплата картой
– Реализовано разделение общей логики в базовый класс (WC_Yandex_Base_Gateway)
– Улучшено хранение ссылок платежей:
• Платежные URL сохраняются в метаданные заказа
• Исключено повторное создание платежей для существующих заказов

1.0.5

• Исправлена совместимость с WooCommerce 8.7
• Обновлены тестовые сценарии для PHP 8.3

1.0.4

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

1.0

• Первый релиз
• Базовая интеграция Яндекс Пей/Сплит
• Поддержка классического редактора