> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/cases/case-yookassa.md).

# Кейс: приём оплаты через ЮKassa

Пошаговая инструкция: как подключить бота и принимать оплату прямо в нём через ЮKassa — от подключения магазина до автоматизации, которая создаёт платёж, отправляет ссылку и реагирует на результат опл

Эта инструкция показывает весь путь целиком — от подключения магазина ЮKassa до автоматизации, которая создаёт платёж, отправляет пользователю ссылку на оплату и продолжает сценарий в зависимости от того, оплатил пользователь счёт, отменил или не оплатил вовсе.

{% hint style="info" %}
**Что в итоге получится:** пользователь доходит до нужного шага в боте (например, выбрал тариф) → graspil создаёт платёж напрямую через API ЮKassa и присылает пользователю ссылку на оплату → после оплаты (или отмены, или истечения времени ожидания) автоматизация продолжается по соответствующей ветке — можно выдать доступ, поблагодарить, напомнить об оплате и т.д.
{% endhint %}

{% hint style="warning" %}
Оплата идёт напрямую через API ЮKassa, а не через встроенные платежи Telegram — это даёт больше контроля над данными платежа. Подключение — через авторизацию ЮKassa (OAuth), в один клик, без ввода технических ключей.
{% endhint %}

{% hint style="info" %}
Если что-то непонятно по ходу настройки — откройте чат со встроенным AI-ассистентом в личном кабинете и опишите задачу своими словами, он подскажет конкретные шаги под вашу ситуацию.
{% endhint %}

***

## Шаг 1. Подключаем бота

Чтобы автоматизация могла отправлять сообщения и реагировать на события пользователя, сначала подключите бота — подробная инструкция в [«Подключение бота»](/ru/connect-bot.md).

## Шаг 2. Подключаем интеграцию с ЮKassa

1. Перейдите в раздел **«Интеграции»** в личном кабинете.
2. Найдите карточку **ЮKassa** в списке доступных интеграций и нажмите **«Настроить»**.
3. Нажмите **«Подключить»** — вас перенаправит на страницу авторизации ЮKassa.
4. Войдите в свой аккаунт ЮKassa (если ещё не вошли), выберите магазин, доступ к которому хотите выдать, и подтвердите разрешение.
5. Вас автоматически вернёт обратно в личный кабинет graspil — интеграция подключена.

{% hint style="info" %}
Никаких технических ключей вводить не нужно, и ничего не нужно донастраивать в кабинете ЮKassa вручную — уведомления об оплате graspil регистрирует автоматически сразу после подключения.
{% endhint %}

Кнопкой **«Проверить соединение»** можно в любой момент убедиться, что доступ ещё активен. Если доступ отозван (например, вы отключили приложение в настройках ЮKassa) — переподключите интеграцию тем же способом.

## Шаг 3. Создаём автоматизацию

Готового шаблона в каталоге пока нет — схему нужно собрать вручную, в разделе **«Автоматизации»** ([подробная документация](/ru/app/automations.md)).

1. Откройте **«Автоматизации»** → **«Создать автоматизацию»**, выберите бота.
2. Добавьте **триггер** — например, нажатие кнопки «Купить» или любое другое событие, после которого пользователю пора выставить счёт.
3. Добавьте блок действия **«Интеграции»** → **«Создать платёж (ЮKassa)»** и заполните:
   * **Интеграция** — та, что вы подключили в Шаге 2.
   * **Сумма** — число (например, `990.00`) или шаблон, например `{{ event.value }}`, если сумма зависит от выбора пользователя.
   * **Валюта** — по умолчанию `RUB`.
   * **Описание платежа** — что увидит пользователь и сама ЮKassa, например `Оплата тарифа Про`.
   * **Таймаут ожидания оплаты** — сколько минут ждать оплату, прежде чем считать, что пользователь передумал.
4. У блока три выхода — соедините каждый со своим продолжением сценария:

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

   Отдельный блок «Ожидание события» добавлять не нужно — блок «Создать платёж» уже сам умеет ждать результат оплаты, ждать нужно только соединить готовые выходы дальше по схеме.
5. От блока «Создать платёж» к следующему шагу (например, блоку «Отправить сообщение» на выходе **«Оплачено»**) добавьте сообщение со ссылкой на оплату — используйте переменную `{{ steps.<id>.confirmation_url }}` (id блока подставится автоматически при выборе переменной в конструкторе сообщения).
6. Соедините все блоки стрелками, нажмите **«Запустить тест»**, чтобы проверить схему, и опубликуйте автоматизацию.

{% hint style="info" %}
Типичная схема: **Триггер → Создать платёж → Отправить сообщение со ссылкой** (сразу после создания платежа, не дожидаясь оплаты) **→** дальше от выхода **«Оплачено»** — выдача доступа/благодарность, от **«Отменено»**/**«Не оплачено»** — например, напоминание или предложение попробовать снова.
{% endhint %}

***

## Реакция на оплату в другой автоматизации

Событие «оплата ЮKassa прошла успешно» доступно и как обычный триггер **«По событию»** в любой другой автоматизации того же бота — например, если вы хотите не просто продолжить ту же цепочку, а параллельно запустить отдельный сценарий (уведомить менеджера, добавить пользователя в отдельный сегмент и т.д.). Полный список событий — в [«Списке событий»](/ru/app/reports/events.md).

***

## Нужна помощь с настройкой?

Если что-то не получается или остались вопросы — обратитесь в поддержку graspil, мы поможем настроить приём оплаты через ЮKassa под вашу ситуацию.