Приём оплаты в Telegram-боте — API Click, Payme, Paynet

01Как проходит оплата

Пользователь нажимает в боте «Пополнить баланс» или «Купить».
Ваш бот отправляет сумму на POST /create и выдаёт pay_url из ответа кнопкой.
Пользователь выбирает Click, Payme или Paynet на странице checkout и платит.
На callback_url бота приходит status=paid — проверяете подпись и пополняете баланс или выдаёте товар.

02Для чего подходит

Пополнение баланса в боте: Stars, Premium, номера, SMM-услуги и другое.
Оплата подписки, курса или доступа в закрытый канал.
Оплата заказов в ботах-магазинах.

Для каждого бота открывается отдельная касса: свой баланс, API-ключ и платёжные системы. Для ботов, созданных в RoxBuilder, заявка на кассу отправляется в один клик.

03Пример кода бота

Python, обычный HTTP — работает с aiogram, pyTelegramBotAPI и любой другой библиотекой.

import requests

API = 'https://pay.tolovgo.uz/api'
KALIT = 'KASSA_API_KALIT'
BOT = 'https://api.telegram.org/botBOT_TOKEN'

def tolov_havolasi(user_id, summa):
    r = requests.post(f'{API}/create', headers={'X-Api-Key': KALIT}, data={
        'amount': summa,
        'callback_url': f'https://bot.example.uz/tolov?uid={user_id}',
    })
    return r.json()['pay_url']

def tolov_tugmasi(chat_id, summa):
    requests.post(f'{BOT}/sendMessage', json={
        'chat_id': chat_id,
        'text': f"{summa} so'm",
        'reply_markup': {'inline_keyboard': [[
            {'text': 'Оплатить', 'url': tolov_havolasi(chat_id, summa)},
        ]]},
    })

Документация API → X-Rox-Signature

04Панель и деньги

В панели — оплаченные, ожидающие и отменённые платежи, общая выручка, выгрузка CSV и месячный PDF-отчёт.
Вебхук можно проверить из панели — убедиться, что бот правильно принимает callback, без реального платежа.
Деньги поступают на баланс кассы (за вычетом 6% комиссии). Вывод на карту: ручной — без комиссии, 1–72 часа; ускоренный — 1%, от 1 минуты до 18 часов.
Аккаунт открывается по коду из email, вход через Telegram — по желанию.

Подробнее о платёжном API и checkout →

05Вопросы

Нужны ли Telegram Payments (provider token)?

Нет. Бот отправляет обычную ссылку, оплата проходит на странице checkout TolovGo. Подключать платёжного провайдера в BotFather не нужно.

Какие платёжные системы доступны?

Click, Payme и Paynet. Каждую можно включить или выключить в настройках кассы.

Как связать платёж с пользователем?

Добавьте ID пользователя в callback_url (например ?uid=123) или передайте поля external_id и payer.telegram_id в API v1.

Что если callback придёт дважды?

Callback может прийти повторно, поэтому зачисляйте платёж один раз по его ID. Подпись приходит в заголовке X-Rox-Signature.

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

6% с каждого платежа. Абонентской платы и платы за подключение нет.

Открыть кассу для бота →

Приём оплаты в Telegram-боте: Click, Payme, Paynet