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

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

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

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

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

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

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

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

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

  • Ваша онлайн-касса - в выпадающем списке выберите Эвотор

  • Адрес сайта, название магазина - адрес вашего сайта

  • Почта — электронный адрес, на который вам удобно получать сообщения об ошибках при отправке чеков

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

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

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

  • Не связывать платёж и чек: данные для чеков отправляются независимо от платежа — этот процесс вы самостоятельно контролируете по API ЮKassa (на http-протоколе это не работает).

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

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

  2. Настройте отправку данных для чеков на вашем сайте

Особенности передачи параметра СНО

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

  • При выставлении счетов из ЛК Юkassa СНО указывается прямо в интерфейсе или по умолчанию в шестеренке справа. Ссылка на раздел

  • При интеграции с помощью CMS/CRM СНО устанавливается в админ. панели самого решения. Раздел обычно указан в инструкции по интеграции

  • При самописной интеграции по API протоколу Это параметр tax_system_code в запросе на создание платежа. Подробнее

  • При самописной интеграции по Email и HTTP Это параметр taxSystem в запросе на создание платежа. Подробнее

Особенности работы с несколькими кассами

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

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

  • использование другого интернет-эквайринга или платежной системы

  • интеграция через посредника Rocketr (оплачивается отдельно)

  • использование другого провайдера облачных касс

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

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

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

Last updated