# Интеграция с Ю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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.evotor.online/nastroika-integracii/integraciya-s-yukassa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
