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

С Telegram-ботами вопрос «чем принимать деньги» решается не сравнением комиссий. Сначала определите, что вы продаёте, и правила сами подскажут способ. Ошибка здесь может стоить самого бота.

21 день
Через столько заработанные ботом звёзды становятся доступны для награды или рекламы.
10 секунд
Столько есть у бота, чтобы подтвердить заказ перед оплатой.
0 %
Комиссия Telegram за платежи картой через провайдера. Провайдер берёт свою.

С чего начать

Главное правило: тип товара

  • Цифровое — доступ к урокам, подписка, файлы, функции бота, игровые предметы. Только Telegram Stars. Так требуют App Store и Google Play: Telegram обязан следовать их правилам о цифровых товарах. Если бот принимает за цифровое другие способы оплаты, владельцу придёт предупреждение, а затем бот могут сделать недоступным в версиях Telegram из магазинов приложений или отключить.
  • Физическое — товары с доставкой, услуги в реальном мире. Оплата картой через стороннего платёжного провайдера, валюта — обычные деньги.
  • Криптовалюта. Если мини-приложение работает с криптовалютой, то только с сетью TON, а кошельки подключаются только через TON Connect. Цифровые товары при этом всё равно продаются за Stars.

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

Три строки: цифровой товар — Stars; физический — карта; криптовалюта — подключение кошелька через TON Connect.
Схема слева направо, по строкам сверху вниз. Цифровое — только Stars; физическое — карта через провайдера; криптовалюта — TON Connect в сети TON.

Таблица

Сравнение способов

Что продаёте

Чем принимать

Правила и комиссии

Как получаете деньги

Цифровые товары и услуги

Telegram Stars (валюта XTR)

Покупатель покупает звёзды через App Store, Google Play или @PremiumBot. Данные карты в бот не вводит

Звёзды на балансе бота. Через 21 день их можно обменять на награду через Fragment или потратить на рекламу. Действуют 3 года

Физические товары и офлайн-услуги

Карта через провайдера, подключённого в BotFather

Telegram комиссию не берёт, провайдер — свою. Сумма примерно от 1 до 10 000 долларов

На счёт у провайдера по его правилам

Оплата криптовалютой

GRAM или токены TON через TON Connect в мини-приложении

Только сеть TON. Цифровое — всё равно за Stars

Сразу на ваш адрес в TON. Возвраты — вручную

О том, чем Stars отличаются от GRAM и почему их путают, — в статье «Telegram Stars и GRAM: в чём разница и почему путаница стоит денег».

Цифровые товары

Stars: как выглядит оплата в коде

Порядок у любого бота один:

  1. Отправьте счёт методом sendInvoice с валютой XTR. Токен провайдера для звёзд не нужен.
  2. Подтвердите заказ в ответ на pre_checkout_query методом answerPreCheckoutQuery в течение 10 секунд, иначе платёж отменится.
  3. Выдайте товар только после successful_payment. Подтверждение заказа ещё не значит, что деньги пришли.
  4. Сохраните telegram_payment_charge_id — без него не сделать возврат.

Фрагмент ниже продолжает бота из статьи «Как создать бота в Telegram: BotFather, первый код на Python и одно правило про токен»: функция call там уже есть.

# Счёт на цифровой постер за 50 звёзд
def send_poster_invoice(chat_id):
    call(
        "sendInvoice",
        chat_id=chat_id,
        title="Цифровой постер",
        description="Файл PNG в высоком разрешении",
        payload="poster-001",
        provider_token="",          # для звёзд оставляют пустым
        currency="XTR",             # Telegram Stars
        prices=[{"label": "Постер", "amount": 50}],
    )


def handle_payment_update(update):
    query = update.get("pre_checkout_query")
    if query:
        # Проверьте, что товар есть, и ответьте за 10 секунд
        call("answerPreCheckoutQuery", pre_checkout_query_id=query["id"], ok=True)
        return

    payment = update.get("message", {}).get("successful_payment")
    if payment:
        charge_id = payment["telegram_payment_charge_id"]
        save_charge(charge_id)      # сохраните для возможного возврата
        deliver_poster(update["message"]["chat"]["id"])


def refund(user_id, charge_id):
    call("refundStarPayment", user_id=user_id, telegram_payment_charge_id=charge_id)

Функции save_charge и deliver_poster — ваши: первая записывает платёж в базу, вторая отправляет покупателю файл.

Правила платформы

Обязанности продавца

  • Поддержка. Бот должен отвечать на команду /paysupport и разбирать вопросы об оплате. Нужны также понятные условия, например по команде /terms, и способ связаться с вами.
  • Споры — ваши. Telegram не посредничает между продавцом и покупателем. Если не получается выполнить заказ, верните звёзды через refundStarPayment: правила платформы прямо разрешают это без штрафа.
  • Последствия. За нерешённые обоснованные жалобы Telegram может списать звёзды с баланса, убрать бота из магазинных версий, повесить метку SCAM и закрыть аккаунт владельца. Звёзды также могут удержать, если покупатель вернул деньги за их покупку через магазин приложений.

Платёжные провайдеры

Карта: физические товары

Оплата картой подключается в BotFather: /mybots → ваш бот → раздел платежей → выбор провайдера. Провайдер выдаст токен, который передаётся в sendInvoice. Пока вы тестируете, используйте тестовый режим Stripe: в нём платежи проходят без списаний, с тестовыми картами.

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

GRAM и токены

Криптовалюта: только TON

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

Такой способ подходит для физических товаров и услуг, если ваши покупатели и так держат GRAM или USDT в TON. Возвраты придётся делать вручную обычным переводом, а цену в GRAM — пересчитывать, потому что курс меняется. Как устроены мини-приложения, разобрано в статье «Что такое Mini Apps в Telegram и как они работают».

Вопросы

Когда можно вывести заработанные звёзды?

Через 21 день после получения. Звёзды обмениваются на награду через Fragment, а минимальная сумма и порядок описаны в статье «Как вывести Telegram Stars: путь от звёзд канала до GRAM».

Раз Telegram дружит с TON, можно продавать цифровое за GRAM?

Нет. Правило о цифровых товарах касается любых способов оплаты, кроме Stars, включая криптовалюту. TON-интеграция разрешает криптовалюту, но не отменяет требование магазинов приложений.

Берёт ли Telegram комиссию?

За платежи картой через провайдера — нет. Со звёздами схема другая: покупатель платит магазину приложений за звёзды, а вы получаете звёзды и обмениваете их по ставке, которую назначает Telegram. Отдельная комиссия 15% появляется, если включить в боте темы в личных чатах.


Способ оплаты в боте выбирает товар. Цифровое — за Stars, физическое — картой через провайдера, криптовалюта — только в TON и для тех, кто к ней готов. Перепутать здесь значит рискнуть самим ботом.

Дальше всё решает аккуратность в коде: товар выдаётся только после успешной оплаты, идентификатор платежа сохраняется, команда /paysupport работает. Этого достаточно, чтобы деньги приходили, а споры не превращались в санкции.