# Приём оплаты

Блоки оплаты выставляют человеку счёт прямо в диалоге: бот присылает ссылку на страницу платёжной системы, а после оплаты ведёт сценарий дальше. На каждую платёжную систему — свой блок, но устроены они одинаково.

## Как работает блок оплаты

1. Сценарий доходит до блока. Блок создаёт платёж в платёжной системе и отправляет человеку сообщение с кнопкой-ссылкой на страницу оплаты.
2. Сразу после этого сценарий идёт дальше по выходу «Продолжить» — не дожидаясь денег.
3. Когда платёжная система сообщает, что счёт оплачен, бот ведёт человека по выходу «Успешная оплата».

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

Блок работает только с подключённой платёжной системой. Она подключается отдельно для каждого бота: откройте в боте «Настройки», вкладку «Интеграции», выберите систему в списке «Возможные интеграции» и введите ключи из её личного кабинета.

![Окно подключения ЮKassa в интеграциях бота: Shop ID, секретный ключ, валюта, налоги](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/09-payments/_images/payment-connect.webp?v=1791781230)

У большинства систем после сохранения появляется адрес для уведомлений (Webhook). Его нужно скопировать в личный кабинет платёжной системы — по этому адресу она сообщает боту об оплате. Без него выход «Успешная оплата» не сработает.

> [!WARNING]
> Если система не подключена, человек вместо счёта получит сообщение вида «Платежная система "…" не подключена.». Подключите систему до того, как запускать бота.

### Настройки

Набор полей у блоков немного разный, но основные повторяются:

- **«Назначение платежа»** — что человек оплачивает. Поле нужно заполнить: с пустым назначением блок не выставит счёт, а отправит человеку сообщение об ошибке.
- **«Описание платежа»** — пояснение к платежу. Тоже обязательно.
- **«Сумма»** — сколько нужно заплатить. Валюта в блоке не выбирается: она зависит от платёжной системы и её настроек в интеграции.
- **«Считывать сумму из пользовательской переменной»** — включите, если сумму считает сценарий. Появится поле **«Имя переменной»**: блок возьмёт сумму из этой переменной контакта. Если переменной у контакта нет, он получит сообщение «Сумма не найдена. Повторите сначала.».
- **«Зачислять деньги на счет пользователя»** — после оплаты сумма зачисляется на внутренний счёт контакта в боте. С этого счёта её можно списывать блоком «Списать со счета контакта».
- **«Способ расчёта»** и **«Предмет расчета»** — признаки для кассового чека: полная предоплата или полный расчёт, товар или услуга и так далее. Есть в блоках систем, которые передают данные чека.
- **«Сообщение чат-бота»** — текст, с которым приходит ссылка на оплату. Напишите `{url}` там, где должна стоять ссылка. Если оставить поле пустым, бот отправит «Ссылка на оплату: …».
- **«Название платежной кнопки»** — подпись кнопки, до 30 символов. Вместо `{amount}` подставится сумма. Если оставить поле пустым, на кнопке будет «Оплатить» и сумма.

В назначении, описании и тексте сообщения работают [автоподстановки](https://support.watbot.ru/chatbots/templates).

![Настройки блока оплаты: назначение и описание, сумма из переменной, зачисление на счёт контакта, сообщение и кнопка](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/09-payments/_images/payment-settings.webp?v=1791781230)

### Выходы

- «Продолжить» — сразу после того, как бот отправил ссылку на оплату. Сюда удобно подключить сообщение «Ждём оплату» или напоминание.
- «Успешная оплата» — когда платёжная система подтвердила платёж. Срабатывает, даже если человек к этому времени ушёл по сценарию дальше.

![Блок оплаты на схеме: выходы «Успешная оплата» и «Продолжить»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/09-payments/_images/payment-outputs.webp?v=1791781230)

Отдельных выходов для отказа от оплаты или истёкшего счёта у блоков нет.

### Особенности

- Кнопка-ссылка приходит в Telegram, ВКонтакте, MAX и в чате на сайте. В остальных каналах кнопки нет, и ссылка уходит текстом сообщения. Поэтому, если вы пишете своё «Сообщение чат-бота», не забудьте в нём `{url}`.
- Нулевую или отрицательную сумму блок не примет: человек получит сообщение об ошибке вместо счёта.
- О выставленных и оплаченных счетах вам приходят уведомления — на почту и в чаты, которые подключены в настройках бота на вкладке «Уведомления».