ЮKassa: приём оплаты и фискализация

ЮKassa закрывает сразу две задачи RetailCRM — приём безналичной оплаты и фискализацию чека по 54-ФЗ. Разбираем, как связать платёж с онлайн-кассой ЮKassa, чтобы клиент получал корректный чек, а статусы оплаты подтягивались в заказ автоматически.

Как работает связка оплаты и фискализации

В отличие от простого эквайринга, ЮKassa умеет не только списывать деньги, но и формировать фискальный чек через встроенную или подключённую онлайн-кассу. Для интернет-магазина это удобно: один платёж — один чек, отдельный сервис фискализации не нужен.

Механика в RetailCRM выглядит так: заказ получает тип оплаты ЮKassa, менеджер или триггер отправляет клиенту платёжную ссылку, клиент платит, а ЮKassa параллельно передаёт данные чека в ОФД. RetailCRM при этом принимает вебхук о смене статуса и переводит оплату в состояние Оплачено.

• Платёж — списание средств с карты, СБП или кошелька;
• Фискализация — формирование чека прихода и его отправка в ФНС через ОФД;
• Синхронизация — возврат статуса и суммы в карточку заказа RetailCRM.

Настройка модуля ЮKassa в RetailCRM

Интеграция подключается из маркетплейса RetailCRM. Порядок действий:

1. Откройте Настройки → Интеграция → Маркетплейс и установите модуль ЮKassa;
2. В личном кабинете ЮKassa получите shopId и секретный ключ (раздел «Интеграция → Ключи API»);
3. Вставьте эти данные в настройки модуля в RetailCRM;
4. Укажите URL для уведомлений (webhook) — модуль подставит его сам;
5. Свяжите созданный тип оплаты в Настройки → Финансы → Типы оплаты с интеграцией.

После активации в списке типов оплаты появится позиция ЮKassa со статусом «Онлайн-оплата». Именно её выбирают в заказе, чтобы стала доступна кнопка формирования платёжной ссылки.

Фискальные атрибуты: НДС, предмет и способ расчёта

Чтобы чек прошёл проверку ОФД, к каждой позиции заказа нужны фискальные признаки. RetailCRM передаёт их в ЮKassa на основе настроек товара и типа оплаты. Основные атрибуты:

Ставку НДС удобно задавать на уровне товарного каталога, чтобы не проставлять её вручную в каждом заказе. Признак способа расчёта важен для предоплат: при частичной оплате в чеке должен стоять Предоплата, а при отгрузке — Полный расчёт.

Статусы оплаты и автоматизация

ЮKassa возвращает несколько состояний платежа, и их полезно сопоставить со статусами оплаты и группами статусов заказа в RetailCRM:

• pending — ссылка создана, клиент ещё не оплатил;
• waiting_for_capture — деньги захолдированы (двухстадийная оплата);
• succeeded — оплата прошла, чек выбит;
• canceled — платёж отменён или просрочен.

На эти события навешиваются триггеры. Типовые сценарии автоматизации:

1. При succeeded — перевести заказ в статус «Оплачен, собираем» и поставить задачу складу;
2. При canceled — вернуть заказ в «Ожидает оплаты» и отправить клиенту напоминание;
3. При зависании в pending дольше суток — уведомить менеджера.

Возвраты и корректировка чеков

При возврате товара нужно не просто вернуть деньги, но и выбить чек возврата прихода. Через модуль ЮKassa это делается из карточки заказа: менеджер оформляет возврат на всю сумму или частично, и ЮKassa формирует корректный фискальный документ.

• Полный возврат — отмена всего заказа, чек на всю сумму;
• Частичный возврат — возврат отдельных позиций, чек только на них;
• Возврат аванса — если была предоплата, указывается тот же признак способа расчёта.

Проверка перед запуском

Перед приёмом реальных платежей прогоните тестовый заказ. Контрольный список:

• Создан тестовый заказ, выбран тип оплаты ЮKassa, сгенерирована ссылка;
• Тестовая оплата прошла, статус в RetailCRM сменился на «Оплачено» автоматически;
• В кабинете ЮKassa и у клиента появился чек с корректным НДС и наименованием товара;
• Оформлен тестовый возврат — чек возврата сформирован;
• Триггеры на смену статуса оплаты сработали как ожидалось.

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

Итог

ЮKassa в RetailCRM — это оплата и фискализация в одном модуле: клиент платит по ссылке, чек уходит в ОФД, а статус возвращается в заказ без ручного контроля. Ключ к стабильной работе — корректные фискальные атрибуты (НДС, признаки предмета и способа расчёта) и продуманные триггеры на статусы оплаты.

Мы настраиваем связку ЮKassa и онлайн-кассы под конкретную систему налогообложения, проверяем чеки на соответствие 54-ФЗ и выстраиваем автоматизацию статусов, чтобы финансовая часть RetailCRM работала прозрачно и без расхождений.