Botconsole предоставляет надежную экосистему платежей без кода, которая позволяет создателям ботов подключать международные и местные платежные шлюзы, выдавать ссылки на одноразовые платежи, запускать подписки и автоматизировать пути клиентов на основе результатов платежей.
В этой статье описаны возможности платежей Botconsole, подробно объясняется, как настроить ссылки на платежи и подписки в визуальном конструкторе ботов, подчеркиваются ключевые различия между одноразовыми платежами и подписками, а также объясняются все настройки конфигурации простыми, нетехническими терминами.
1. Настройка шлюза и возможности провайдера
Перед добавлением платежных ссылок в разговорные потоки вашего бота вам необходимо подключить и настроить предпочитаемые платежные шлюзы в Botconsole.
Подключение платежных провайдеров
Botconsole поддерживает широкий спектр платежных шлюзов, обслуживающих глобальные и региональные рынки, включая Stripe, PayPal, T-Bank (Тинькофф), YooKassa, LemonSqueezy, FreeKassa, Cryptomus, CryptoBot, Robokassa, Payeer и Telegram Stars / Telegram Invoices.
Для каждого подключенного шлюза владельцы ботов просто вводят свои учетные данные (такие как API-ключи, секретные ключи, открытые ключи или ID магазинов/кошельков) в настройках бота. Ключевые учетные данные надежно хранятся для каждого бота.
Режим песочницы и тестовые платежи
Тестирование потоков оформления заказа перед приемом реальных средств от клиентов имеет решающее значение. Botconsole включает переключатель Тестовый режим (песочница) для подключенных платежных провайдеров. Когда он включен:
- Вы можете тестировать взаимодействия с кнопками, генерацию платежных ссылок и автоматизированные переходы потоков, используя данные тестового платежа.
- Реальные средства не списываются, что позволяет вам тщательно протестировать процесс регистрации пользователей, предоставление доступа к приватным каналам и обработку ошибок.
Совместимость подписки (allow_recurrent)
Не все платежные шлюзы поддерживают автоматические повторяющиеся списания. Например, базовые ссылки на криптовалюту или простые провайдеры одноразовых счетов поддерживают только одноразовые транзакции, в то время как Stripe, PayPal, LemonSqueezy и T-Bank поддерживают привязку карт для повторяющихся платежей или управление подписками.
Botconsole автоматически проверяет возможности шлюза:
- При настройке Ссылки на одноразовый платеж все активные платежные провайдеры доступны.
- При настройке Ссылки на подписку Botconsole фильтрует список, чтобы отобразить только провайдеров, поддерживающих повторяющиеся платежи (
allow_recurrent). Это предотвращает неправильные конфигурации и гарантирует, что клиенты никогда не столкнутся с неудачными повторяющимися платежами.
2. Ссылки на одноразовые платежи (payment_link)
Ссылки на одноразовые платежи предназначены для одноразовых, не повторяющихся транзакций, когда клиент платит один раз за продукт или услугу.
Типичные случаи использования
- Продажа электронных книг, руководств, шаблонов программного обеспечения или загружаемых файлов.
- Билеты на одноразовые мероприятия или доступ к вебинарам.
- Одноразовые консультации или сборы за услуги.
- Покупка физических товаров или депозиты на индивидуальные заказы.
- Пополнение баланса счета.
Настройки конструктора и конфигурация
В визуальном конструкторе потоков Botconsole добавление кнопки платежа с действием payment_link открывает интуитивно понятную панель настроек:
| Настройка | Что это | Зачем это нужно |
|---|---|---|
| Платежный провайдер | Выбирает подключенный платежный шлюз для этой кнопки. | Позволяет направлять разные продукты на разные торговые счета или шлюзы (например, Stripe для международных карт, YooKassa для местных платежей). |
| Сумма | Сумма взимания. Поддерживает фиксированные числа (например, 99.00) или динамические переменные (например, {{order_total}}). |
Позволяет устанавливать динамическое ценообразование на основе выбора пользователя, выбранных количеств или рассчитанных итогов корзины. |
| Валюта | Целевая валюта транзакции (например, USD, EUR, RUB, USDT). | Указывает валюту, передаваемую на страницу оформления заказа платежного шлюза. |
| Описание | Описание товара, отображаемое на странице оформления заказа шлюза. | Информирует клиента о том, за что он платит на экране платежного шлюза. |
| Применить личную скидку | Переключатель для включения скидок, специфичных для пользователя. | Автоматически пересчитывает сумму платежа на основе скидок, назначенных отдельным пользователям бота. |
| Скидка на одноразовое использование | Применяет скидку только к текущей транзакции. | Предотвращает автоматическое применение скидок к будущим покупкам, если они заданы как одноразовая акция. |
| Узел успеха | Разговорный блок/узел, выполняемый после подтверждения платежа. | Мгновенно отправляет купленный продукт, выдает ключи доступа или запускает автоматизированное выполнение заказа. |
| Узел ошибки | Разговорный блок/узел, выполняемый, если платеж не удался или был отменен. | Вежливо предлагает клиенту попробовать другой способ оплаты или предлагает помощь. |
| Префикс переменной | Имя контейнера переменной (по умолчанию payment). |
Управляет тем, как данные платежа хранятся в сессии бота (например, {{payment.order_id}}, {{payment.amount}}). |
| Пользовательская нагрузка / параметры | Пары ключ-значение, прикрепленные к транзакции (например, sku, promo_code). |
Передает пользовательские метаданные отслеживания через шлюз и обратно в ваши потоки бота для отслеживания заказов. |
Автоматизированные динамические переменные
После успешного платежа Botconsole заполняет переменные в сессии бота пользователя для последующих узлов:
{{payment.id}}— ID записи платежа.{{payment.order_id}}— Уникальный номер отслеживания заказа.{{payment.amount}}&{{payment.currency}}— Окончательная сумма и валюта платежа.{{payment.status}}— Статус платежа (paid,failedи т.д.).{{payment.paid_at}}— Временная метка подтверждения.{{payment.payload.KEY}}— Пользовательские метаданные, переданные в параметрах платежа.
3. Ссылки на подписку и повторяющиеся платежи (subscribe)
Ссылки на подписку позволяют создателям ботов строить модели повторяющегося дохода, автоматически выставляя счета клиентам через фиксированные временные интервалы.
Типичные случаи использования
- Платные VIP-каналы Telegram или приватные группы (доступ на месяц или год).
- Повторяющиеся членства в контенте, новостные рассылки или торговые сигналы.
- Подписки на SaaS-ботов или разблокировка премиум-функций.
- Поддержка или повторяющиеся планы обслуживания.
Ключевые различия: одноразовые и подписочные ссылки
| Функция | Ссылка на одноразовый платеж (payment_link) |
Ссылка на подписку (subscribe) |
|---|---|---|
| Частота выставления счетов | Взимается один раз. | Автоматически выставляется счет на повторяющейся основе (например, каждые 30 дней). |
| Поддержка шлюза | Совместима со всеми активными платежными провайдерами. | Требует шлюзов с поддержкой повторяющихся платежей/привязки карт (allow_recurrent). |
| Узлы жизненного цикла | 2 узла: Успех и Ошибка. | 5 узлов: Начальный успех, Начальная ошибка, Успех продления, Ошибка продления, Отмена. |
| Удержание клиентов | Заканчивается после доставки заказа. | Постоянно управляет активным доступом, попытками повторного выставления счетов и автоматическим отзывом доступа при отсутствии платежа. |
| Скидки | Применяются к одной транзакции. | Могут применяться к первоначальному платежу, сохраняя обычную цену для последующих продлений. |
Настройки конструктора и конфигурация
При настройке кнопки с типом действия subscribe:
| Настройка | Что это | Зачем это нужно |
|---|---|---|
| Провайдер подписки | Выбирает платежный шлюз, способный к подписке. | Гарантирует, что шлюз поддерживает сохранение карт и автоматическое повторяющееся выставление счетов. |
| Повторяющаяся сумма | Базовая цена, взимаемая на каждом интервале продления. | Устанавливает предсказуемую повторяющуюся цену для вашей услуги. |
| Валюта | Валюта выставления счета. | Определяет валюту для первоначальных и повторяющихся платежей. |
| Период выставления счета (дни) | Интервал между повторяющимися платежами (например, 30 дней для ежемесячных, 7 дней для еженедельных). | Определяет продолжительность подписки и автоматически рассчитывает даты следующего продления. |
| Скидка на первый платеж | Необязательная скидка, применяемая только к первому циклу выставления счета. | Позволяет вводить пробные цены или рекламные скидки на первый месяц. |
| Максимальное количество попыток повторного выставления счета | Количество попыток повторного выставления счета при неудачных продлениях (например, 3 попытки). | Предоставляет клиентам льготный период для пополнения карты перед отзывом доступа. |
| Узел успеха | Узел, запускаемый после успешного первого платежа. | Приветствует новых подписчиков, предоставляет ссылки на приглашения в приватные каналы или доставляет первоначальное обучение. |
| Узел ошибки | Узел, запускаемый, если первоначальная привязка карты/платеж не удалась. | Уведомляет пользователя о том, что авторизация карты была отклонена. |
| Узел продления | Узел, запускаемый при каждом успешном автоматическом продлении. | Отправляет квитанцию о продлении и продлевает членство в канале без вмешательства пользователя. |
| Узел неудачного продления | Узел, запускаемый, когда все попытки повторного выставления счета не удались. | Автоматически отзывает доступ к каналу, удаляет пользователя из VIP-групп и отправляет уведомление о истечении доступа. |
| Узел отмены | Узел, запускаемый, когда подписка отменяется. | Подтверждает отмену и информирует пользователя о том, когда закончится их текущий оплаченный период. |
| Префиксы переменных | Контейнеры переменных для платежа (payment) и состояния подписки (sub). |
Обеспечивает метаданные подписки (например, {{sub.status}}, {{sub.next_charge_at}}) для узлов бота. |
4. Управление подпиской в боте и отмена (cancel_subscription)
Предоставление пользователям простого способа управления и отмены своих подписок создает доверие и обеспечивает соблюдение глобальных норм подписки.
Botconsole предлагает встроенный тип действия кнопки: cancel_subscription.
Как работает отмена
Botconsole обрабатывает отмену без проблем в соответствии с архитектурой платежного шлюза:
- Внутренняя пассивная отмена: Для шлюзов, где Botconsole управляет запланированными повторяющимися платежами, отмена немедленно помечает статус подписки как отмененный, чтобы будущие платежи не происходили.
- Активная отмена API: Для шлюзов, таких как Stripe или LemonSqueezy, которые управляют графиками подписок на своей стороне, Botconsole вызывает API провайдера, чтобы автоматически остановить будущие выставления счетов.
- Портал самообслуживания для клиентов: Для шлюзов, требующих внешнего управления порталом, Botconsole генерирует прямую, персонализированную ссылку на панель управления выставлением счетов клиента.
После отмены Botconsole автоматически запускает настроенный Узел отмены, обновляя переменные подписки в реальном времени.
5. Мгновенные уведомления и предотвращение ошибок
Надежность системы и четкая коммуникация гарантируют, что вы никогда не пропустите продажу или не столкнетесь с тихими ошибками конфигурации.
Уведомления владельца бота в реальном времени
Каждый раз, когда платеж или подписка успешно обрабатываются, Botconsole уведомляет владельца бота через три канала:
- Уведомление в приложении: Доступно внутри панели управления Botconsole.
- Уведомление в Telegram: Прямое уведомление, отправленное на личный аккаунт Telegram владельца бота.
- Уведомление по электронной почте: Отправлено на зарегистрированный адрес электронной почты.
Уведомления содержат информацию о названии бота, имени пользователя/ID покупателя, описании товара, сумме, валюте и статусе цикла подписки.
Проактивные уведомления об ошибках
Если клиент нажимает на платежную ссылку, но ссылка не удается сгенерировать (например, из-за истекших учетных данных API или простоя шлюза), Botconsole мгновенно отправляет уведомление владельцу бота через Telegram:
⚠️ Ошибка генерации платежной ссылки
Бот: VIP Traders Bot
Провайдер: Stripe
Кнопка: Обновить до VIP ($99)
Ошибка: Неверный секретный ключ
[🔧 Открыть конструктор]
Это позволяет владельцам ботов немедленно решить проблемы с учетными данными шлюза, не упуская потенциальный доход.
6. Интеграция блока базы данных для платежных потоков
Для сложных сценариев бота Botconsole включает Блок базы данных с выделенным источником данных payment. Создатели ботов могут запрашивать и проверять историю платежей в потоке бота без кода:
- Получить платеж по ID / номеру заказа: Проверяет конкретные транзакции во время запросов поддержки пользователей.
- Получить платежи клиента: Извлекает все прошлые платежи, сделанные текущим пользователем, чтобы отобразить историю транзакций.
- Получить все платежи бота: Запрашивает платежи по всему боту с пользовательскими фильтрами (например, диапазоны дат, статус платежа, минимальные суммы) для генерации пользовательских отчетов или предоставления многоуровневых вознаграждений.
Резюме
Botconsole преобразует обработку платежей в Telegram в визуальный опыт перетаскивания:
- Гибкость: Подключайте несколько международных и местных платежных шлюзов для каждого бота с тестированием в песочнице.
- Универсальность: Принимайте одноразовые платежи или запускайте автоматизированные повторяющиеся подписки с гибкими периодами выставления счетов.
- Автоматизация: Направляйте клиентов через индивидуализированные потоки бота на основе первоначальных платежей, продлений, неудач и отмен.
- Надежность: Мгновенные уведомления о продажах через несколько каналов и автоматические уведомления об ошибках.
С Botconsole монетизация вашего присутствия в Telegram проста, надежна и полностью автоматизирована.
