> For the complete documentation index, see [llms.txt](https://help.zenky.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zenky.io/pay/yookassa.md). # Подключение эквайринга от ЮКасса ## Подготовка к подключению Для подключения эквайринга от ЮКасса вам нужно создать аккаунт на [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 в качестве платёжного провайдера выберите опцию **«ЮКасса»**.

Выбор платёжного провайдера.

После выбора **«ЮКасса»** вам станут доступны дополнительные настройки. ### Выбор схемы оплаты ЮКасса позволяет проводить онлайн-платежи по двум схемам: 1. Одностадийная. В этом случае при онлайне-оплате деньги сразу списываются с карты покупателя и запускается процесс их перевода на ваш счёт в ЮКасса (откуда затем они будут отправлены на ваш расчётный счёт за минусом комиссии ЮКасса). Если после успешной оплаты вы по какой-то причине отмените заказ, деньги покупателю будут возвращены в течение нескольких рабочих дней (как правило, 1-3 рабочих дня); 2. Двухстадийная. В этом случае в момент оплаты ЮКасса не списывает деньги с карты, а замораживает (холдирует) их, чтобы покупатель не смог ими распорядиться. Фактическое списание произойдёт только после того, как заказ перейдёт в статус **«Выполнен»**. Если до выполнения заказа вы отмените его, деньги вернутся покупателю практически моментально.
{% hint style="danger" %} **Будьте внимательны!** Если вы выберите двухстадийную схему оплаты, для получения средств вам обязательно нужно будет перевести заказ в статус **«Выполнен»** (либо вручную в панели управления магазином Zenky, либо через интеграцию с Iiko или Frontpad). **Если этого не сделать, деньги будут возвращены покупателю автоматически со стороны ЮКасса через 3-7 дней после совершения платежа!** {% endhint %} ### ID магазина ЮКасса В поле **«ID магазина ЮКасса»** нужно указать ваш `shopId` из личного кабинета ЮКасса.
Для того, чтобы узнать `shopId`, перейдите в раздел [**«Настройки» – «Магазин»** в личном кабинете ЮКасса](https://yookassa.ru/my/shop-settings) (если у вас несколько магазинов в ЮКасса, убедитесь, что выбран правильный).

ID магазина в личном кабинете ЮКасса.

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

Секретный ключ API в личном кабинете ЮКасса.

{% hint style="info" %} **Обратите внимание** Ключ на скриншоте выше начинается с префикса **`test_`**. Это означает, что он принадлежит тестовому магазину. Ключ для работы в "боевом" режиме имеет префикс **`live_`** и показывается **только один раз после создания**. Если вы его не сохраните сразу же, вам придётся его перевыпустить. Если у вас уже был создан боевой магазин в ЮКасса, а текущий ключ был утерян, вам придётся его перевыпустить, чтобы скопировать его для работы с Zenky. Так же, если вам потребуется узнать ключ после подключения к Zenky, вам может потребоваться перевыпустить его. В этом случае вам нужно будет обновить ключ и в настройках Zenky, а так же изменить адреса HTTP-уведомлений (см. ниже). Без этого интеграция в Zenky перестанет работать. {% endhint %} ### Онлайн-касса При подключении магазина в ЮКасса, вам потребуется настроить работу онлайн-кассы. В зависимости от того, какую онлайн-кассу вы используете, зависит процесс создания платежей и формирования онлайн-чеков. Выберите тип кассы, которую вы используете в ЮКасса.

Выбор тип онлайн-кассы.

{% 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 вы увидите блок **«Уведомления ЮКасса»**. Если вы ещё не сохранили настройки интеграции, вы увидите предупреждение:

Предупреждение при первичной настройке ЮКасса.

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

Информация об HTTP-уведомлениях от ЮКасса.

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

Страница HTTP-уведомлений в личном кабинете ЮКасса.

Нажмите на кнопку **«Изменить настройки»**. Справа откроется модальное окно с полем **«URL для уведомлений»** и галочками **«Выбранные события»**. В поле **«URL для уведомлений»** вставьте адрес, который вы скопировали ранее в панели управления магазином Zenky. В списке **«Выбранные события»** отметьте следующие события галочками: * `payment.succeeded` * `payment.wating_for_capture` * `payment.cancelled` * `refund.succeeded`

Настройки уведомений в личном кабинете ЮКасса.

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

Предупреждение о недоступности ЮКасса в мобильном приложении магазина.

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

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

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