> For the complete documentation index, see [llms.txt](https://docs.wfolio.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wfolio.pro/shop/payments/yookassa.md).

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

Как подключить платежную систему Ю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% — для остальных способов оплаты.

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

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

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

* **Описание товаров и услуг.**
* **Стоимость.** Цены и тарифы должны быть видны пользователю перед оформлением заказа.
* **Способы доставки и получения.** Как пользователь получит товар или услугу после оплаты.
* **Контакты и реквизиты.** ФИО, телефон, адрес электронной почты, реквизиты самозанятого или ИП.
* **Ссылка на оферту с юридической информацией.**

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

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

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

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

<figure><img src="https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/ARCzQz2oCzIOMlpeHTDk/yookassa%20connect%20new.png" alt="" width="226"><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/oy1eCSYCQk7UqOOKgK7a/wfolio%20yookassa%20connect%20new2.png" alt=""><figcaption></figcaption></figure>

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

![](https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/RqHNx75qvjEhX1RUU0GV/api%20keys%20yookassa%20new.png)

<figure><img src="https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/qJPsApyWTX69B2ZmwMUG/shop%20id%20yookassa.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/YBdvErhsjWaOfNoHvlQW/yookassa%20connect%20again%20ru.png" 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://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/pMywwIzgSvK1BCAqeAAI/http%20yookassa%20new.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wrI7NDNFBB58HnLs55bo/blobs/D46McbJjBTUe4vqXoEdV/yookassa%20http%20check%20new.png" alt=""><figcaption></figcaption></figure>