> For the complete documentation index, see [llms.txt](https://docs.evotor.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.evotor.online/nastroika-integracii/integraciya-s-yukassa.md).

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

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

1. **Войдите** в [ЛК Юkassa](https://yookassa.ru/my/)
2. **Перейдите** в раздел [Настройки → Онлайн-касса](https://yookassa.ru/my/fiscalization-settings)
3. **Подтвердите**, что вам нужно отправлять чеки\
   ![](/files/pQBJoTc2U832t5GNPsWw)
4. **Подтвердите**, что у вас есть онлайн-касса\
   ![](/files/gBySaKEny4nDbjFXVM7C)
5. **Заполните** поля. Параметры для подключения не нужны — просто укажите настройки чеков:\
   ![](/files/cuGqnFWJj7P2xM30Yw56)

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

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

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

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

{% hint style="info" %}
Рекомендуем выставить параметр **Принимать платёж.** Даже если касса не ответила, платёж пройдёт. При отсутствии чека вы сможете пробить чек коррекции и не потеряете продажу
{% endhint %}

6. На следующем шаге ещё раз **проверьте** настройки и, если всё в порядке, **подтвердите**
7. **Настройте** отправку данных для чеков на вашем сайте

<details>

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

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

* **При выставлении счетов из ЛК Юkassa** \
  СНО указывается прямо в интерфейсе или по умолчанию в шестеренке справа. [Ссылка на раздел](https://yookassa.ru/my/invoice)
* **При интеграции с помощью CMS/CRM** \
  СНО устанавливается в админ. панели самого решения. Раздел обычно указан в инструкции по интеграции
* **При самописной интеграции по API протоколу** \
  Это параметр **tax\_system\_code** в запросе на создание платежа. [Подробнее](https://yookassa.ru/developers/payment-acceptance/receipts/54fz/other-services/parameters-values)
* **При самописной интеграции по Email и HTTP** \
  Это параметр **taxSystem** в запросе на создание платежа. [Подробнее](https://yookassa.ru/docs/payment-solution/payments/payment-form/receipts#parameters)

</details>

<details>

<summary>Особенности работы с несколькими кассами</summary>

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

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

* использование другого интернет-эквайринга или платежной системы
* интеграция через посредника [Rocketr](/nastroika-integracii/integraciya-s-rocketr.md) (оплачивается отдельно)
* использование другого провайдера облачных касс

</details>

{% hint style="info" %}
**Если вы сами настраиваете интеграцию по API**

Добавьте параметры для чека (название товаров, их цены, ставку НДС, информацию о покупателе) в запросы на оплату. Подробнее — [в документации](https://yookassa.ru/developers/payment-acceptance/scenario-extensions/54fz/basics)
{% endhint %}

{% hint style="danger" %}
Для пользователей Смарт терминалов должно быть [установлено приложение "Цифровая касса"](https://market.evotor.ru/store/apps/2778de62-57ee-4324-8f17-d89f17c91872). Без него интеграция работать не будет
{% endhint %}

{% embed url="<https://yookassa.ru/docs/support/merchant/payments/settings54fz>" %}
Ссылка на полную версию инструкции от ЮKassa
{% endembed %}

{% embed url="<https://market.evotor.ru/store/apps/2778de62-57ee-4324-8f17-d89f17c91872>" %}
Приложение Цифровая касса для смарт-терминалов Эвотор
{% endembed %}