# Подключение Ю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). Для успешного прохождения проверки платежной системы важно, чтобы были указаны:

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

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

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

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

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

<figure><img src="/files/XJ3yy3lA2aeXzAWYNMJj" alt="" width="226"><figcaption></figcaption></figure>

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

<figure><img src="/files/mGJZARNp9AfAdADbLeqI" alt=""><figcaption></figcaption></figure>

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

![](/files/QXcyhRERUfXLfq65fQYt)

<figure><img src="/files/5AXUFzkLTTolRVNMl3wC" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/qdcTMKQZqPJua8zm8HbD" 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="/files/cxguk6UiGl8pJdLKBYLD" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/OGujHm5q9el5nbv7FAIQ" alt=""><figcaption></figcaption></figure>


---

# 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.wfolio.pro/shop/payments/yookassa.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.
