# Подключение ЮKassa

[**ЮKassa**](https://yookassa.ru/?source=wfolio) — сервис онлайн-платежей для самозанятых, ИП и юрлиц. С ее помощью можно принимать платежи банковскими картами, СБП, электронными деньгами, наличными через терминалы и другими платежными средствами.

#### Комиссии ЮKassa

Комиссия зависит от способа оплаты и вычитается за каждый успешный платеж, поступивший на ваш счет. Ставки указаны для новых клиентов ЮKassa, зарегистрировавшихся [по ссылке Wfolio](https://yookassa.ru/joinups/?source=wfolio).

<table><thead><tr><th width="271">Способ оплаты</th><th>Для самозанятых</th><th>Для ИП</th></tr></thead><tbody><tr><td>Банковские карты</td><td>2.50%</td><td>2.50%</td></tr><tr><td>СБП</td><td>от 0.20%</td><td>от 0.20%</td></tr><tr><td>SberPay*</td><td>2.50%</td><td>2.50%</td></tr><tr><td>T-Pay*</td><td>от 3.00%</td><td>от 3.00%</td></tr></tbody></table>

{% hint style="info" %}
\*Для подключения этого способа оплаты сделайте запрос в личном кабинете ЮKassa.
{% endhint %}

Сервис «Чеки» от ЮKassa для отправки фискальных чеков в налоговую по 54-ФЗ (настройте при подключении или в личном кабинете) — 1.50% от суммы платежа для СБП и 0.40% — для остальных способов оплаты.

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

### Как подготовиться к подключению

Добавьте товары или услуги [на сайт](https://docs.wfolio.pro/shop/site/products) или [в галерею](https://docs.wfolio.pro/shop/gallery/products). Для успешного прохождения проверки платежной системы важно, чтобы были указаны:

* **Описание товаров и услуг.**
* **Стоимость.** Цены и тарифы должны быть видны пользователю перед оформлением заказа.
* **Способы доставки и получения.** Как пользователь получит товар или услугу после оплаты.
* **Контакты и реквизиты.** ФИО, телефон, адрес электронной почты, реквизиты самозанятого или ИП.
* **Ссылка на** [**оферту с юридической информацией**](https://docs.wfolio.pro/legal/terms)**.**

### Подключить ЮKassa

* [Зарегистрируйтесь в **ЮKassa**](https://yookassa.ru/joinups/?source=wfolio). Введите ваш номер телефона и полученный код из СМС.
* После регистрации в панели управления ЮKassa заполните анкету, загрузите необходимые документы и подпишите договор.

{% hint style="info" %}
Проверка вашей анкеты и подписание договора занимает, как правило, от 1 до 3 рабочих дней. Подробную информацию вы можете уточнить в службе поддержки ЮKassa. После проверки анкеты и подписания договора у вас будут все данные, чтобы завершить подключение.
{% endhint %}

* В личном кабинете ЮKassa перейдите в раздел **«Интеграция»** → **«Готовые решения»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FMJVz0PPWhMkExnzUhexa%2Fyookassa%20connect%20new2.png?alt=media&#x26;token=1c944f76-ffb0-41e2-a5c7-d869045ad8a9" alt="" width="226"><figcaption></figcaption></figure>

* Найдите и выберите **Wfolio** в списке готовых решений. Нажмите **«Сохранить»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FdEgNkcaDUhztxQrn5btx%2Fwfolio%20yookassa%20connect%20new2.png?alt=media&#x26;token=9a3d89bb-92ea-4ad9-b02f-e2d514d5ce4a" alt=""><figcaption></figcaption></figure>

* Перейдите в раздел **«Интеграция»** → **«Ключи API»** и скопируйте свои **shopId** (только цифры) и **секретный ключ**. Секретный ключ начинается с `live_`.

![](https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2Fd7yLAAglKkH8fudIk1wE%2Fapi%20keys%20yookassa%20new.png?alt=media\&token=4adfb24e-5a14-4b5e-b6a0-979870015658)

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FQUAuAqBXGhKif1v5Gmpu%2Fshop%20id%20yookassa.png?alt=media&#x26;token=eb9ec480-d9e6-48f7-81fa-7b87f7716cb9" alt=""><figcaption></figcaption></figure>

* На Wfolio перейдите в раздел магазина **«Платежные сервисы»** и активируйте переключатель **ЮKassa**.
* Вставьте скопированные значения **shopId** и **секретного ключа** `live_` в соответствующие поля. Нажмите кнопку **«Добавить»**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FUqCummCQtu4Oky9OXiWU%2Fyookassa%20connect%20again%20ru.png?alt=media&#x26;token=d363673a-4eba-49a0-a745-55b2abffa890" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Проведите тестовый платеж после подключения системы

Ваш заказ должен отобразиться в разделе **«Магазин» → «Заказы»**.

Если оплата прошла, но заказа нет или спустя несколько часов он появился в разделе «Незавершенные заказы», проверьте настройки платежной системы еще раз.
{% endhint %}

### Ставка НДС и чеки от ЮKassa

Для работы по 54-ФЗ ЮKassa предоставляет сервис автоматической отправки чеков в налоговую и покупателям. Сервис можно активировать в процессе подключения или в личном кабинете ЮKassa.

{% hint style="info" %}
Для **самозанятых** и **индивидуальных предпринимателей на УСН** (упрощенной системе налогообложения) ставку НДС выбирать не нужно.
{% endhint %}

В панели управления Wfolio в разделе магазина **«Платежные сервисы»**[ ](https://wfolio.ru/my/settings/payment_methods)настройте отправку данных для чека в онлайн-кассу, указав вашу **ставку НДС**.

### Подключение оплаты в рассрочку/кредит

ЮKassa предоставляет возможность подключить прием платежей в рассрочку или кредит с сервисом «Покупки в кредит» от СберБанка. Опция доступна для индивидуальных предпринимателей. Перед подключением ознакомьтесь с условиями сервиса.

Для подключения напишите менеджеру ЮKassa или оставьте заявку в личном кабинете.

После подключения дополнительная настройка на Wfolio не требуется. Клиенты смогут выбрать покупку в рассрочку или кредит в окне оплаты товара.

### Проверка HTTP-уведомления <a href="#http" id="http"></a>

Для корректной работы платежной системы нужно HTTP-уведомление — оно отправляет данные о платежах на сервер Wfolio. Сейчас это уведомление прописывать не нужно, потому что у ЮКассы есть [готовый модуль для подключения](#podklyuchit-yukassa).

**Если вы подключали ЮKassa не через модуль**, убедитесь, что уведомления и события настроены корректно: выберите раздел **«Интеграция» → «HTTP-уведомления»**. В пункте **«URL для уведомлений»** должна быть эта ссылка:

```
https://wfolio.ru/gateway/integrations/yookassa/notify
```

Выбранные события должны быть: **payment\_succeeded**, **payment.waiting\_for\_capture**, **payment\_canceled**, **refund\_succeeded**.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FygGAdEyccwVUcClwuOSl%2Fhttp%20yookassa%20new.png?alt=media&#x26;token=47d5c18f-fcdf-4190-96ba-65244fcafde6" alt=""><figcaption></figcaption></figure>

Если подключение было через готовый модуль, то уведомление настроилось автоматически.

<figure><img src="https://355501785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtZOPvCqrx5oWXGbl7B-887967055%2Fuploads%2FtimJMEjWH2yLU3hRaZG9%2Fyookassa%20http%20check%20new.png?alt=media&#x26;token=3519e52b-490d-4977-bcbe-2ea32f8025d7" alt=""><figcaption></figcaption></figure>
