# Подключение эквайринга от ЮКасса

## Подготовка к подключению

Для подключения эквайринга от ЮКасса вам нужно создать аккаунт на [https://yookassa.ru](https://yookassa.ru/), создать новый магазин и пройти все необходимые верификации со стороны ЮКасса.

{% hint style="danger" %}
**Оплата через ЮКасса может быть недоступна в мобильных приложениях**

Если ваш магазин в Zenky имеет опубликованное мобильное приложение в App Store и Google Play, онлайн-оплата заказов через ЮКасса в ваших приложениях может быть недоступна.

Для подключения оплаты через ЮКасса потребуется выпустить обновление для вашего приложения. Пожалуйста, свяжитесь с вашим менеджером или напишите в чат техподдержки, чтобы сделать запрос на подключение ЮКасса в вашем мобильном приложении.

Оплата через ЮКасса для вашего сайта, работающего на Zenky, будет доступна без дополнительных обновлений.
{% endhint %}

## Настройка эквайринга в Zenky

После того, как ваша заявка в ЮКасса будет одобрена, вы можете приступить к настройке интеграции на стороне Zenky. Вам потребуется доступ в личный кабинет ЮКасса для изменения настроек уведомлений и получения идентификатора магазина и секретных ключей.

В разделе [**«Магазин» – «Онлайн-оплата»**](https://my.zenky.io/dashboard/store/profile/settings/payments) панели управления магазином Zenky в качестве платёжного провайдера выберите опцию **«ЮКасса»**.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FubMfjy5lEO6cgtgW9i2A%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.52.24.png?alt=media&#x26;token=8c7b1e46-fdc0-4b5f-8eb3-8ae819a6a90f" alt=""><figcaption><p>Выбор платёжного провайдера.</p></figcaption></figure>

После выбора **«ЮКасса»** вам станут доступны дополнительные настройки.

### Выбор схемы оплаты

ЮКасса позволяет проводить онлайн-платежи по двум схемам:

1. Одностадийная. В этом случае при онлайне-оплате деньги сразу списываются с карты покупателя и запускается процесс их перевода на ваш счёт в ЮКасса (откуда затем они будут отправлены на ваш расчётный счёт за минусом комиссии ЮКасса). Если после успешной оплаты вы по какой-то причине отмените заказ, деньги покупателю будут возвращены в течение нескольких рабочих дней (как правило, 1-3 рабочих дня);
2. Двухстадийная. В этом случае в момент оплаты ЮКасса не списывает деньги с карты, а замораживает (холдирует) их, чтобы покупатель не смог ими распорядиться. Фактическое списание произойдёт только после того, как заказ перейдёт в статус **«Выполнен»**. Если до выполнения заказа вы отмените его, деньги вернутся покупателю практически моментально.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FOyBTQNOUXhlFcXwANPWX%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.52.44.png?alt=media&#x26;token=bb0d957e-21f0-4331-9732-9f4a332c4b91" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Будьте внимательны!**

Если вы выберите двухстадийную схему оплаты, для получения средств вам обязательно нужно будет перевести заказ в статус **«Выполнен»** (либо вручную в панели управления магазином Zenky, либо через интеграцию с Iiko или Frontpad).

**Если этого не сделать, деньги будут возвращены покупателю автоматически со стороны ЮКасса через 3-7 дней после совершения платежа!**
{% endhint %}

### ID магазина ЮКасса

В поле **«ID магазина ЮКасса»** нужно указать ваш `shopId` из личного кабинета ЮКасса.&#x20;

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FUXEEnvUjauu3aJ4mDIyv%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.52.55.png?alt=media&#x26;token=fd83a772-dc3b-4b5d-a0bd-ffacd5ff5757" alt=""><figcaption></figcaption></figure>

Для того, чтобы узнать `shopId`, перейдите в раздел [**«Настройки» – «Магазин»** в личном кабинете ЮКасса](https://yookassa.ru/my/shop-settings) (если у вас несколько магазинов в ЮКасса, убедитесь, что выбран правильный).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FsJhHQ7GMsgBxr4sWSVcN%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.04.47.png?alt=media&#x26;token=6dfbb41c-9e28-4a75-a929-8cf2d48a11a7" alt="" width="375"><figcaption><p>ID магазина в личном кабинете ЮКасса.</p></figcaption></figure>

### Секретный ключ ЮКасса

В поле **«Секретный ключ ЮКасса»** нужно вставить секретный ключ API ЮКасса. Он нужен для работы с API, а так же для проверки платежей, уведомления о которых мы будем получать.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2F1GcSjNRofEhxaQiFZsuQ%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.53.42.png?alt=media&#x26;token=0ae3eabd-a136-410c-82cd-f2de5b163fb7" alt=""><figcaption></figcaption></figure>

Для того, чтобы узнать секретный ключ API для вашего магазина, перейдите в раздел **«Интеграция» – «Ключи API»** в личном кабинете ЮКасса (если у вас несколько магазинов в ЮКасса, убедитесь, что выбран правильный).

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FEhrRgMpSjizPrCaAVDeq%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.09.02.png?alt=media&#x26;token=b0213989-da54-483e-8635-e4daf1962e92" alt=""><figcaption><p>Секретный ключ API в личном кабинете ЮКасса.</p></figcaption></figure>

{% hint style="info" %}
**Обратите внимание**

Ключ на скриншоте выше начинается с префикса **`test_`**. Это означает, что он принадлежит тестовому магазину. Ключ для работы в "боевом" режиме имеет префикс **`live_`** и показывается **только один раз после создания**. Если вы его не сохраните сразу же, вам придётся его перевыпустить.

Если у вас уже был создан боевой магазин в ЮКасса, а текущий ключ был утерян, вам придётся его перевыпустить, чтобы скопировать его для работы с Zenky.

Так же, если вам потребуется узнать ключ после подключения к Zenky, вам может потребоваться перевыпустить его. В этом случае вам нужно будет обновить ключ и в настройках Zenky, а так же изменить адреса HTTP-уведомлений (см. ниже). Без этого интеграция в Zenky перестанет работать.
{% endhint %}

### Онлайн-касса

При подключении магазина в ЮКасса, вам потребуется настроить работу онлайн-кассы. В зависимости от того, какую онлайн-кассу вы используете, зависит процесс создания платежей и формирования онлайн-чеков. Выберите тип кассы, которую вы используете в ЮКасса.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FSOEG0UC7SgVHqoF1gLtK%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.53.53.png?alt=media&#x26;token=5fc4bc8e-e4d8-431d-b62d-c34b36abc777" alt=""><figcaption><p>Выбор тип онлайн-кассы.</p></figcaption></figure>

{% hint style="warning" %}
**Обратите внимание**

Во время формирования онлайн-чеков мы обязаны передавать **ставку НДС** для каждой позиции заказа и **систему налогообложения** ИП или юридического лица, которому принадлежит магазин.

Ставку НДС по умолчанию (для всех товаров) вы можете настроить в разделе [**«Магазин» – «Настройки каталога»** в панели управления магазином Zenky](https://my.zenky.io/dashboard/store/profile/settings/catalog).

Дополнительно вы можете настроить ставку НДС для каждого отдельного товара. Для этого откройте **редактирование товара** в панели управления магазином Zenky и заполните поле **«Ставка НДС»**. Если товар не облагается НДС, в поле **«НДС»** выберите опцию **«Не облагается»**.

Систему налогообложения можно выбрать в разделе [**«Магазин» – «Реквизиты и документы»** панели управления магазином Zenky](https://my.zenky.io/dashboard/store/profile/legal).
{% endhint %}

## HTTP-уведомления от ЮКасса

Для того, чтобы мы могли узнать статус оплаты заказов, необходимо настроить HTTP-уведомления от ЮКасса. URL-адреса уведомлений нужно брать в панели управления магазином Zenky, а указывать их – в личном кабинете ЮКасса.

В самом низу раздела [**«Магазин» – «Онлайн-оплата»**](https://my.zenky.io/dashboard/store/profile/settings/payments) панели управления магазином Zenky вы увидите блок **«Уведомления ЮКасса»**. Если вы ещё не сохранили настройки интеграции, вы увидите предупреждение:

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FF0bnar8pSbwliFFqgq9u%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.23.57.png?alt=media&#x26;token=7997b266-9b49-4b6c-9051-184b12e44e49" alt=""><figcaption><p>Предупреждение при первичной настройке ЮКасса.</p></figcaption></figure>

Сохраните все настройки (включая ID магазина и секретный ключ), а затем обновите страницу. На месте этого предупреждения будет блок с информацией об HTTP-уведомлениях.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FOaBMzaDFKwWaAQGIQGXd%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2018.54.24.png?alt=media&#x26;token=0ffa035c-7281-4046-8cf3-f31860afb677" alt=""><figcaption><p>Информация об HTTP-уведомлениях от ЮКасса.</p></figcaption></figure>

Скопируйте URL уведомлений и перейдите в раздел [**«Интеграция» – «HTTP-уведомления»** в личном кабинете ЮКасса](https://yookassa.ru/my/merchant/integration/http-notifications) (если у вас несколько магазинов в ЮКасса, убедитесь, что выбран правильный). Там вы увидите URL для уведомлений и текущие подключенные события.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FV8DK5bQWbiXGcGoBfagp%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.29.08.png?alt=media&#x26;token=7f7a4302-5e7f-484d-af42-b7021fc50b2d" alt="" width="375"><figcaption><p>Страница HTTP-уведомлений в личном кабинете ЮКасса.</p></figcaption></figure>

Нажмите на кнопку **«Изменить настройки»**. Справа откроется модальное окно с полем **«URL для уведомлений»** и галочками **«Выбранные события»**.

В поле **«URL для уведомлений»** вставьте адрес, который вы скопировали ранее в панели управления магазином Zenky. В списке **«Выбранные события»** отметьте следующие события галочками:

* `payment.succeeded`
* `payment.wating_for_capture`
* `payment.cancelled`
* `refund.succeeded`

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FgIEgL4B99afzn9NT0DBH%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.33.04.png?alt=media&#x26;token=ac83712a-575d-4cd9-9420-1ca6de443106" alt="" width="375"><figcaption><p>Настройки уведомений в личном кабинете ЮКасса.</p></figcaption></figure>

Нажмите на **«Сохранить»**. Если вы делали настройку для тестового магазина, вы можете начать тестировать платежи, используя [тестовые карты ЮКасса](https://yookassa.ru/developers/payment-acceptance/testing-and-going-live/testing#test-bank-card). Если ваш магазин в ЮКасса уже в боевом режиме, вы можете проверить платежи любой рабочей картой.

## Оплата в мобильных приложениях

Если ваш магазин в Zenky имеет опубликованное мобильное приложение в App Store и Google Play, онлайн-оплата заказов через ЮКасса в ваших приложениях может быть недоступна. В этом случае вы увидите такое предупреждение:

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FojkS95zad3Do5cFBLBgj%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.39.43.png?alt=media&#x26;token=80155fda-fd31-492b-a5a1-a9c864ad64fc" alt=""><figcaption><p>Предупреждение о недоступности ЮКасса в мобильном приложении магазина.</p></figcaption></figure>

Для подключения оплаты через ЮКасса потребуется выпустить обновление для вашего приложения. Пожалуйста, свяжитесь с вашим менеджером или напишите в чат техподдержки, чтобы сделать запрос на подключение ЮКасса в вашем мобильном приложении.

Оплата через ЮКасса для вашего сайта, работающего на Zenky, будет доступна без дополнительных обновлений.

## Подключение способа оплаты ЮКасса

Финальный шаг – включить способ оплаты «ЮКасса» в настройках заказов вашего магазина. Для этого перейдите в раздел [**«Магазин» – «Настройки заказов»** в панели управления магазином Zenky](https://my.zenky.io/dashboard/store/profile/settings/orders). Проскролльте форму до раздела **«Способы оплаты»** и найдите способ оплаты **«Картой онлайн (ЮКасса)»**. Включите переключатель и сохраните настройки.

<figure><img src="https://1480690874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1B1BMwmRkGzV5C4BnU%2Fuploads%2FGBrVbNn5RczPbYFCftvf%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-10%20%D0%B2%2019.42.39.png?alt=media&#x26;token=96bcb110-8cdd-4fe3-aaec-c3af1860f0de" alt=""><figcaption><p>Подключение способа оплаты ЮКасса.</p></figcaption></figure>

Этот способ оплаты будет отображаться покупателям как **«Картой онлайн»**. Если нужно, вы можете переименовать его в поле **«Название»**.