Перейти к основному содержимому

Интеграция с Юkassa

Описание интеграции Цифровой кассы с интернет-эквайрингом Юkassa

Для настройки интеграции Цифровой кассы с интернет-эквайрингом Юkassa:​

  1. Войдите в ЛК Юkassa

  2. Перейдите в раздел Настройки → Онлайн-касса

  3. Подтвердите, что вам нужно отправлять чеки

    Интеграция с Юkassa

  4. Подтвердите, что у вас есть онлайн-касса

    Интеграция с Юkassa

  5. Заполните поля. Параметры для подключения не нужны — просто укажите настройки чеков:

    Интеграция с Юkassa

Где принимаете платежи?​

  • Ваша онлайн-касса — в выпадающем списке выберите Эвотор
  • **Адрес сайта, название магазина — ** адрес вашего сайта
  • Почта — электронный адрес, на который вам удобно получать сообщения об ошибках при отправке чеков

Что делать с платежом, если чек не доставлен?​

  • Принимать платёж: сначала проходит платёж, а потом в онлайн-кассу отправляются данные для чека. Платёж пройдёт, даже если онлайн-касса не ответила. Но чек может так и не отправиться — в этом случае на почту для ошибок придёт письмо. Эта настройка подходит для большинства интернет-магазинов, продающих физические товары.
  • Отменять платёж: сначала в вашу онлайн-кассу отправляются данные для чека. Платёж проходит после того, как от неё придёт ответ, что с чеком всё в порядке. Если онлайн-касса не ответит в течение 5 минут (например, что-то случится на стороне провайдера), оплата не пройдёт: деньги вернутся покупателю. Эта настройка подходит для магазинов, которые продают цифровые товары без доставки.
  • Не связывать платёж и чек: данные для чеков отправляются независимо от платежа — этот процесс вы самостоятельно контролируете по API ЮKassa (на http-протоколе это не работает).

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

  1. На следующем шаге ещё раз проверьте настройки и, если всё в порядке, подтвердите
  2. Настройте отправку данных для чеков на вашем сайте
Особенности передачи параметра СНО

Способ передачи параметра СНО зависит от сценария:

  • При выставлении счетов из ЛК Юkassa
    СНО указывается прямо в интерфейсе или по умолчанию в шестеренке справа. Ссылка на раздел
  • При интеграции с помощью CMS/CRM
    СНО устанавливается в админ. панели самого решения. Раздел обычно указан в инструкции по интеграции
  • При самописной интеграции по API протоколу
    Это параметр tax_system_code в запросе на создание платежа. Подробнее
  • При самописной интеграции по Email и HTTP
    Это параметр taxSystem в запросе на создание платежа. Подробнее
Особенности работы с несколькими кассами

Юkassa использует упрощенную интеграцию с Эвотор, поэтому может передавать чеки только на одну группу касс.

Если у одного ЮЛ или ИП несколько интернет-магазинов, подключенных к Юкассе, и отдельные Цифровые кассы для них, то чеки получится формировать только по одному магазину. Для второго интернет-магазина потребуется использование альтернативных решений:

  • использование другого интернет-эквайринга или платежной системы
  • интеграция через посредника Rocketr (оплачивается отдельно)
  • использование другого провайдера облачных касс

Если вы сами настраиваете интеграцию по API

Добавьте параметры для чека (название товаров, их цены, ставку НДС, информацию о покупателе) в запросы на оплату. Подробнее — в документации

Для пользователей Смарт терминалов должно быть установлено приложение "Цифровая касса". Без него интеграция работать не будет

Документация ЮKassыСсылка на версию инструкции от ЮKassa Эвотор МаркетСсылка на приложение Цифровая касса для смарт-терминалов Эвотор