Как принимать оплату в боте MAX через ЮKassa

Оплата в боте MAX сокращает путь от предложения до заказа. Клиент видит цену в диалоге, получает ссылку ЮKassa и после подтверждения продолжает сценарий. MAXorg не хранит данные карты: платёж проходит на стороне ЮKassa, а воронка ждёт успешный статус.

Ниже показана рабочая схема для услуги, записи или цифрового продукта. Для тренировки создайте кабинет на странице регистрации MAXorg. Готовые варианты применения можно посмотреть в каталоге.

Что подготовить до настройки

В ЮKassa нужны активный магазин, shopId и секретный ключ. В MAXorg реквизиты можно сохранить для аккаунта или указать в блоке оплаты. Не смешивайте варианты: либо задайте полную пару в блоке, либо оставьте оба поля пустыми и используйте настройки аккаунта. Секрет не вставляйте в сообщения, ссылки и базу знаний.

Для чека нужен email. Бот может запросить адрес у покупателя перед созданием платежа. Если запрос выключен, используется email владельца кабинета. Также заполните username бота MAX: он нужен для удобного возврата клиента в диалог после страницы ЮKassa.

• Проверьте, что магазин ЮKassa принимает платежи.
• Подготовьте shopId и секретный ключ.
• Укажите username подключённого бота.
• Определите точную сумму и понятное название услуги.
• Решите, чей email использовать для чека.

До запуска согласуйте предмет расчёта и чек со специалистом, который ведёт вашу кассу. Техническое подключение не заменяет настройку магазина ЮKassa и правила возврата денег клиенту.

Как собрать платёжную воронку

Начните с пяти блоков: старт, сообщение с предложением, оплата, подтверждение, завершение. В сообщении до оплаты напишите, что получает клиент, сколько это стоит и что произойдёт после платежа. Например: «Консультация длится 60 минут и стоит 3 500 ₽. После оплаты пришлём инструкцию».

Кнопка из предложения должна вести в блок «Оплата». Все действия для покупателя ставьте после него: выдачу файла, инструкцию, добавление в сегмент или карточку CRM. Нажатие кнопки и переход на страницу ЮKassa ещё не означают, что деньги получены.

1. Выберите бота в разделе ботов.
2. Добавьте старт и короткое предложение.
3. Соедините кнопку покупки с блоком «Оплата».
4. После оплаты добавьте подтверждение и следующий шаг.
5. Проверьте все связи и активируйте воронку.

Как заполнить блок оплаты

Укажите сумму в рублях, описание платежа, текст сообщения и подпись кнопки. Описание должно совпадать с предложением и быть понятным в чеке. Формулировка «Онлайн-консультация по рекламе» полезнее слова «Оплата». Не добавляйте в описание лишние персональные данные.

MAXorg позволяет запросить email клиента и ограничить способы оплаты картой или СБП. Реальный набор способов зависит и от настроек магазина ЮKassa. Если продаёте несколько продуктов по разным ценам, сделайте отдельный платёжный блок для каждого варианта.

• Цена в сообщении совпадает с суммой блока.
• Описание объясняет предмет оплаты.
• После блока есть связанное продолжение.
• Email запрашивается только тогда, когда он нужен.
• Клиент понимает, куда обратиться при сбое.

Как принимать оплату за бронирование

Для консультаций и услуг по расписанию используйте блок «Бронирование». В нём задаются рабочие дни, доступное время и часовой пояс. Если включить обязательную оплату, клиент сначала выбирает слот, затем получает ссылку ЮKassa. После успеха MAXorg закрепляет запись и может создать карточку CRM с датой.

Пока платёж не подтверждён, не обещайте, что время уже занято за клиентом. Если тот же слот успел выбрать другой человек, бот предложит выбрать новое время. Подходящий текст: «Вы выбрали 18 сентября, 15:00. Оплатите запись, чтобы закрепить время».

Что происходит после перехода в ЮKassa

Клиент оплачивает на защищённой странице ЮKassa. MAXorg получает статус операции и продолжает воронку только после подтверждённого успеха. Возврат пользователя в чат сам по себе ничего не подтверждает, поэтому доступ или запись нельзя выдавать по факту открытия ссылки.

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

Главное правило: сообщение «Оплата прошла» и все ценные действия размещайте только после платёжного блока.

Ошибки и проверка результата

Частые причины сбоя просты: неверные реквизиты, отсутствие email для чека, незаполненный username бота, разная цена в тексте и блоке, оборванная связь после оплаты. Если клиент говорит, что заплатил, сначала проверьте статус в ЮKassa и запись в кабинете, а не снимок экрана.

Перед запуском проведите успешный и прерванный платёж двумя отдельными диалогами. Затем откройте историю, проверьте продолжение воронки и целевое действие. После изменения ключа, цены, username или схемы повторите тест. Дополнительные сценарии собраны в блоге MAXorg.

1. Сверьте цену в сообщении, ЮKassa и чеке.
2. Проверьте неверный и корректный email.
3. Убедитесь, что без оплаты доступ не выдаётся.
4. После успеха проверьте сообщение, CRM или сегмент.
5. Закройте страницу без оплаты и оцените повторный путь.
6. Для бронирования проверьте закрепление выбранного слота.