ЮKassa — одна из самых распространённых платёжных систем в российском e-commerce, и в RetailCRM она подключается штатной интеграцией без разработки. Правильная настройка даёт автоматический статус оплаты в заказе, фискальный чек и понятную сверку платежей.
Что даёт связка ЮKassa и RetailCRM
Интеграция ЮKassa (бывшая Яндекс.Касса) с RetailCRM переносит работу с оплатами внутрь карточки заказа. Менеджер выставляет счёт, отправляет клиенту платёжную ссылку, а факт оплаты подтягивается в CRM автоматически — без ручной сверки с личным кабинетом банка.
Ключевые сценарии, которые закрывает связка:
- приём онлайн-оплаты по заказам из сайта, маркетплейсов и мессенджеров в едином окне;
- автоматическая простановка признака
оплаченпри поступлении денег; - формирование фискального чека по 54-ФЗ прямо через ЮKassa;
- возвраты и частичные возвраты с корректным чеком возврата;
- сверка платежей по номеру заказа и
paymentId.
Что нужно подготовить до настройки
Перед подключением убедитесь, что у вас есть действующий договор с ЮKassa и доступ к личному кабинету. Понадобятся два идентификатора и права администратора в RetailCRM.
| Параметр | Где взять | Назначение |
|---|---|---|
| shopId | ЛК ЮKassa → Настройки → Магазин | Идентификатор магазина |
| Секретный ключ | ЛК ЮKassa → Интеграция → Ключи API | Авторизация запросов |
| Права в CRM | Администрирование → Пользователи | Доступ к настройкам оплат |
Секретный ключ выдаётся один раз — сохраните его сразу. Для боевого приёма платежей магазин в ЮKassa должен быть переведён в статус активного, иначе оплаты будут проходить только в тестовом режиме.
live_ для боевого режима и test_ для тестового.Пошаговое подключение в RetailCRM
Интеграция включается из административного раздела CRM. Последовательность действий:
- Откройте
Настройки → Интеграция → Маркетплейси найдите приложение ЮKassa. - Нажмите «Подключить» и введите
shopIdи секретный ключ. - Выберите магазины (символьные коды), для которых будет доступна эта оплата.
- Сохраните — в справочнике
Настройки → Справочники → Типы оплатыпоявится новый способ. - Привяжите тип оплаты к нужным группам статусов заказа.
После сохранения RetailCRM автоматически передаёт в ЮKassa адрес для приёма уведомлений (webhook). Отдельно прописывать URL в ЛК ЮKassa, как правило, не требуется — интеграция регистрирует его сама.
Как приходят статусы оплаты
ЮKassa уведомляет CRM о смене состояния платежа через HTTP-запрос. Основные статусы на стороне платёжной системы и их отражение в заказе:
| Статус ЮKassa | Смысл | Отражение в заказе |
|---|---|---|
| pending | Ожидает оплаты | Оплата создана, не проведена |
| waiting_for_capture | Средства захолдированы | Требует подтверждения списания |
| succeeded | Оплата прошла | Признак «оплачен», сумма зачтена |
| canceled | Отменён | Оплата аннулирована |
Для стандартной схемы «одностадийная оплата» (списание сразу) используйте succeeded как сигнал полной оплаты. Двухстадийная схема с холдированием требует ручного или автоматического capture — учитывайте это при настройке триггеров.
Фискальные чеки через ЮKassa
ЮKassa умеет фискализировать платежи по 54-ФЗ через собственные онлайн-кассы. Чтобы чеки формировались корректно, в заказе RetailCRM у каждой позиции должны быть заполнены налоговые атрибуты.
- Ставка НДС — задаётся в карточке товара или в типе оплаты;
- Признак предмета расчёта — товар, услуга, платёж и т. д.;
- Признак способа расчёта — полная оплата, аванс, предоплата;
- Система налогообложения — должна совпадать с настройками кассы.
При поступлении оплаты ЮKassa пробивает чек прихода, а при возврате — чек возврата прихода. Электронный чек уходит клиенту на e-mail или телефон, указанные в заказе.
Тестирование и типовые ошибки
Перед запуском проведите контрольный платёж. Порядок проверки:
- Создайте тестовый заказ и выставьте оплату ЮKassa.
- Оплатите минимальную сумму (например, 1 ₽) реальной картой или тестовой в песочнице.
- Убедитесь, что заказ получил признак оплаты, а в истории появился
paymentId. - Проверьте приход чека клиенту и корректность сумм.
Наиболее частые проблемы и причины:
| Симптом | Вероятная причина |
|---|---|
| Оплата прошла, но заказ не оплачен в CRM | Не доходит webhook / неверный ключ |
| Ошибка авторизации | Перепутан test и live ключ |
| Чек не пробивается | Нет НДС или СНО у позиций |
Итог
Подключение ЮKassa к RetailCRM — это ввод shopId и секретного ключа, привязка типа оплаты к статусам и настройка налоговых атрибутов для чеков 54-ФЗ. После контрольного платежа система сама проставляет оплату и отправляет фискальный чек, снимая ручную сверку с менеджеров.
Если нужно подключить ЮKassa вместе с онлайн-кассой, доставкой и выгрузкой заказов без ошибок в налоговых реквизитах, мы настраиваем платёжные интеграции RetailCRM под ключ и передаём систему с проверенным приёмом оплаты.
Частые вопросы
Нужен ли отдельный модуль для ЮKassa в RetailCRM?
Нет. ЮKassa подключается штатной интеграцией из маркетплейса приложений, отдельный платный модуль не требуется.
Можно ли подключить несколько магазинов к одной ЮKassa?
Да, можно завести несколько подключений с разными shopId и ключами и привязать каждое к своему магазину и складу.
Кто пробивает чек — RetailCRM или ЮKassa?
Чек фискализируется на стороне ЮKassa через её онлайн-кассы, а CRM передаёт состав заказа и налоговые атрибуты позиций.
Как работают возвраты?
Возврат оформляется по оплате заказа, ЮKassa возвращает средства и пробивает чек возврата прихода автоматически.
Что делать, если оплата прошла, а в CRM заказ не оплачен?
Чаще всего не доходит уведомление о статусе или указан неверный ключ. Проверьте ключ API и повторно сохраните интеграцию.
Поддерживается ли двухстадийная оплата с холдированием?
Да, ЮKassa поддерживает холд и списание, но для схемы waiting_for_capture нужно настроить подтверждение списания.
Обязательно ли указывать НДС у товаров?
Для корректной фискализации через ЮKassa налоговая ставка и система налогообложения должны быть заданы у позиций заказа.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.