Прием платежей в телеграм боте: как подключить СБП, карты и USDT

Как принимать оплату в Telegram-боте: общая схема

Бот — это только интерфейс: он показывает товары и принимает команды. Саму оплату обрабатывает платёжный шлюз. Он выдаёт покупателю страницу оплаты, принимает деньги и сообщает вашему боту, что платёж прошёл.

Подключить оплату можно двумя путями:

• Платёжные ссылки. Вы создаёте ссылку на оплату в кабинете, а бот отправляет её покупателю. Подходит, если товаров немного и писать код не хочется.
• API и вебхуки. Бот сам создаёт платёж под каждый заказ и получает уведомление об оплате. Это путь для автовыдачи, подписок и пополнения баланса.

Paydex поддерживает оба варианта: платёжные ссылки и страница оплаты работают без кода, а для автоматизации есть REST API и SDK для Node.js, PHP и Python. Начать можно со ссылок, а потом перейти на API, когда заказов станет больше.

Какие способы оплаты подключить в боте: СБП, карты или USDT?

Чем больше удобных способов, тем меньше покупателей уходит на этапе оплаты. Paydex принимает три основных: СБП, банковские карты РФ и USDT. Каждый закрывает свою аудиторию.

Нужен ли ИП, чтобы принимать платежи в телеграм боте?

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

Деньги от покупателей копятся на балансе в USDT. Выводить их можно в USDT (сети TRC20 и BEP20) или в рублях — на карту либо по СБП. Выбираете то, что удобнее именно вам.

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

Как подключить оплату к телеграм боту за день

Весь путь от регистрации до первых оплат состоит из пяти шагов. Большая часть времени уходит на модерацию, которая обычно занимает до суток.

1. Регистрация. Создайте аккаунт в Paydex — для этого достаточно личных данных обычного пользователя.
2. Проект. Добавьте новый проект и выберите тип «Telegram-бот». Укажите название, описание и тематику.
3. Подтверждение бота. Подтвердите, что бот принадлежит вам. Для сайта на этом шаге подтверждается домен.
4. Модерация. Проверяется работающий бот, товары и цены, оферта и контакты. Обычно это занимает до суток.
5. Ключи API. После одобрения вы получаете ключи и подключаете их в код бота или создаёте платёжные ссылки в кабинете.

Пошаговое описание интеграции есть в быстром старте. Пока проект на проверке, подготовьте текст оферты и логику выдачи товара, чтобы после одобрения сразу запустить продажи.

Как работает оплата через API и вебхуки

Схема для автоматического приёма платежей одинакова для большинства ботов. Разберём её по шагам и отдельно — то, на чём чаще всего ошибаются.

От кнопки «Купить» до выдачи товара

1. Покупатель выбирает товар и нажимает «Купить» или «Оплатить».
2. Бот создаёт заказ в вашей базе и запрашивает у Paydex платёж через API, передавая сумму и номер заказа.
3. Бот отправляет покупателю ссылку на страницу оплаты со способами СБП, карта или USDT.
4. Покупатель платит.
5. Paydex отправляет на ваш сервер подписанный вебхук о статусе платежа.
6. Сервер проверяет подпись, находит заказ по номеру, меняет статус на «оплачен» и выдаёт товар в чате.

На что обратить внимание в вебхуках

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

Для интеграции есть готовые SDK для Node.js, PHP и Python, поэтому подпись и запросы не придётся писать с нуля. Полное описание методов — в документации API.

Как настроить автоматическую выдачу товара в боте

Автовыдача — это когда после подтверждения оплаты бот сам отдаёт покупателю то, что он купил. Выдавать можно разные вещи:

• ключи, коды и промокоды из заранее загруженного списка;
• файлы и ссылки на материалы;
• доступ в закрытый чат или канал;
• пополнение внутреннего баланса или продление подписки.

Правила надёжной автовыдачи

1. Храните у каждого заказа статус: «создан», «ожидает оплаты», «оплачен», «выдан».
2. Переводите заказ в «оплачен» только после проверенного вебхука.
3. Блокируйте повторную выдачу: если заказ уже «выдан», повторное уведомление просто игнорируется.
4. Для штучных товаров, например ключей, резервируйте единицу при создании заказа, чтобы два покупателя не получили один и тот же ключ.
5. Сообщайте покупателю о ходе оплаты: «ждём подтверждение» и «оплата получена, вот ваш товар».

Добавьте кнопку «Проверить оплату». Она показывает актуальный статус заказа из вашей базы, которую обновляют вебхуки. Особенно это полезно для USDT: подтверждение в блокчейне занимает больше времени, и клиенту нужно понимать, что платёж не потерялся.

Как пройти модерацию Telegram-бота

Модерация нужна, чтобы убедиться, что за проектом стоит реальный бизнес, а покупатель понимает, что и на каких условиях он покупает. Проверяют несколько вещей:

• Работающий бот. Он отвечает на команды, а описание и меню понятны новому пользователю.
• Товары и цены. Покупатель видит, что продаётся и сколько это стоит, ещё до оплаты.
• Публичная оферта с блоком «Возврат». В ней описаны условия покупки и порядок возврата. Ссылка на оферту доступна из бота.
• Контакты. Для связи указаны аккаунт поддержки или другой способ, через который клиент получит ответ.

Перед отправкой на проверку пройдите бота глазами нового покупателя: нажмите «Старт», откройте каталог, найдите цену, оферту и контакты. Если на каком-то шаге вы сами засомневались, модератор тоже задаст вопрос.

Тестирование, возвраты, вывод и стоимость

Проверьте оплату до запуска

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

Возвраты покупателям

Возврат можно оформить через кабинет или по API. Если в боте есть кнопка «Запросить возврат», подключите возвраты через API, чтобы не делать каждый вручную. Порядок возврата обязательно опишите в оферте.

Вывод денег

Деньги накапливаются на балансе в USDT. Вывести их можно в USDT (TRC20 или BEP20) либо в рублях — на карту или по СБП.

Сколько это стоит

У Paydex нет абонентской платы и платы за подключение. Комиссия зависит от оборота и тематики проекта, актуальные условия смотрите на странице тарифов. Если появятся вопросы по интеграции, поддержка отвечает в Telegram.