# Юкасса

### Шаг 0. Зарегистрируйтесь в ЮKassa (если аккаунта ещё нет)

Для подключения интернет-эквайринга от Юкасса к магазину необходимо быть зарегистрированным в Юкассе, для этого подайте заявку [ссылке.](https://yookassa.ru/joinups/?source=tgshp)

{% hint style="info" %}
Если у вас уже есть аккаунт в ЮKassa с подключённым интернет-эквайрингом — пропустите этот шаг и переходите к Шагу 1
{% endhint %}

<figure><img src="/files/YVOkzXLV4quGPI0ssdJM" alt=""><figcaption><p>Регистрация в Юкасса</p></figcaption></figure>

<figure><img src="/files/wFJTjnC1PyfreYSeLX44" alt=""><figcaption><p>Выберите юр.лицо или самозанятость для регистрации</p></figcaption></figure>

Выберите cпособ подключения “На сайте”.

<figure><img src="/files/s5KybGIaESNwUXNbnqtR" alt=""><figcaption><p>Настройка способа приема платежей </p></figcaption></figure>

{% hint style="info" %}
**Важно перед подачей заявки:** \
В личном кабинете TGShop перейдите в настройки магазина —> Приветственное сообщение —> в приветственном сообщении Telegram-магазина обязательно добавьте следующую информацию для успешного прохождения проверки Юкассы:<br>

«Продажу товаров осуществляет:

ИП ФИО / Название компании

Все права защищены. ОГРНИП: (укажите номер)

Контакты службы поддержки:

📧 Ссылка на менеджера

🔗 Ссылка на канал (при наличии)»&#x20;
{% endhint %}

В заявке укажите ссылку на ваш бот с активированным магазином и товарами, чтобы быстро пройти проверку. Ссылка на бот в формате: <https://t.me/названиевашегобота\\_bot> — вы можете найти название бота в ЛК TGShop ниже названия магазина или в @BotFather в Telegram, где вы создавали бота.

<figure><img src="/files/I4Xe2RTK7kWT9svRFVCQ" alt=""><figcaption><p>Заполнение анкеты для регистрации в Юкассе</p></figcaption></figure>

\
Настройте выставление чеков вашим клиентам, по умолчанию Юкасса предлагает подключить свой сервис “Облачные чеки от Юкасса” либо вы можете выбрать другую онлайн-кассу и подключить ее. В обоих случаях - подключение онлайн-кассы происходит в ЛК Юкассы, дополнительно подключать онлайн-кассу в лк TGShop не требуется.

<figure><img src="/files/1uIoKFWFzeTWjoLjus6x" alt=""><figcaption><p>Настройка онлайн-кассы для выставления чеков </p></figcaption></figure>

В зависимости от выбранного вами типа: ИП / ООО / Самозанятый - пройдите по инструкции Юкассы и заполните все данные и отправьте заявку на проверку.

### Шаг 1. Подключение Юкасса к TGShop&#x20;

1. После того, как у вас появился магазин в ЛК Юкасса, перейдите в **ЛК TGShop.**
2. Перейдите в **Настройки магазина** и выберите вкладку **Оплата**.
3. Нажмите кнопку **Добавить онлайн оплату** и выберите из списка **ЮKassa**.
4. После добавления на странице появится карточка **ЮKassa** с кнопкой **Авторизация**. Нажмите на неё.

{% hint style="info" %}
**Важно: для настройки платежей - у вас должны быть соответствующие права в лк Юкасса.**&#x20;
{% endhint %}

Откроется страница авторизации ЮKassa. Сервис запросит доступ к вашему профилю со следующими правами: просмотр возвратов, создание платежей, сохранение и использование способов оплаты, просмотр платежей.

5. Нажмите **Разрешить**, чтобы продолжить.

<figure><img src="/files/obQsUfiOKX7hPAHtuvuA" alt=""><figcaption><p>Настройка разрешения доступа бота тестовому ShopID от Юкасса</p></figcaption></figure>

6. На следующем экране выберите магазин, к которому хотите подключить TGShop. Магазины отображаются во вкладке **Можно выдать доступ**.
7. Отметьте нужный магазин и нажмите **Выдать доступ**.

{% hint style="info" %}
Если нужного магазина нет в первой вкладке, проверьте вкладки **Нельзя выдать доступ** и **Неактивные** — возможно, у вас недостаточно прав или магазин неактивен.
{% endhint %}

<figure><img src="/files/cubu9szP3FbaPzZyF895" alt=""><figcaption><p>Выдача доступа для бота к вашему ShopID </p></figcaption></figure>

8. После успешного подключения кнопка на карточке ЮKassa изменится с **Авторизация** на **Настроить**.

### Шаг 2. Настройка параметров оплаты&#x20;

Нажмите **Настроить** на карточке ЮKassa. Откроется форма — заполните все поля.

**Название способа оплаты** — это название покупатель увидит в боте при оформлении заказа. Используйте понятную формулировку, например: «Оплата картой» или «Онлайн оплата»

**Предмет расчёта** — указывает, что именно оплачивает покупатель; отражается в фискальном чеке.&#x20;

**Признак способа расчёта** — определяет, когда покупатель получает товар относительно оплаты.&#x20;

**Система налогообложения** — укажите систему, которую применяете; данные попадают в фискальный чек. Если не уверены — уточните у бухгалтера.

**Ставка НДС** — также отражается в фискальном чеке.&#x20;

{% hint style="warning" %}
**Важно:** для фискализации сначала подключите её в личном кабинете ЮKassa в настройках магазина.
{% endhint %}

Нажмите **Сохранить** — интеграция настроена.

### Частые вопросы:&#x20;

<details>

<summary><strong>Нет нужного магазина в списке</strong></summary>

Проверьте, что вы авторизованы в ЮKassa под аккаунтом с правами администратора магазина.

</details>

<details>

<summary><strong>Кнопка «Сохранить» неактивна</strong></summary>

Заполните все обязательные поля формы (предмет расчёта, признак способа расчёта, система налогообложения).

</details>

<details>

<summary><strong>Хочу переподключить другой магазин</strong></summary>

Нажмите на три точки (**⋮**) в правом верхнем углу карточки ЮKassa и выберите нужное действие.

</details>


---

# 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.tgshop.io/osnovnye-nastroiki/sposoby-oplaty/yukassa.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.
