03 · Оплата виртуальной валютой Stars
Используется для открытия нативного чекаута Telegram для списания Stars и безопасной выдачи товаров.
Способы интеграции
Track A — Использование готового префаба
- Откройте сцену
03_StarsPayment_Demo. - Перетащите
FastTMA_StarsPayButtonподCanvasили в панель магазина. - Выберите кнопку и настройте параметры
TelegramStarsButtonв Inspector:
| Поле | Описание |
|---|---|
| Product Id | Уникальный идентификатор товара (например, vip_pass_tier1) |
| Title | Заголовок чекаута, максимум 32 символа (например, 30-дневный VIP) |
| Description | Описание товара, максимум 255 символов |
| Stars Price | Количество Stars для списания (например, 50) |
- Привязка начисления наград: В слоте
On Purchase Success (String)нажмите +, перетащите скрипт выдачи (например,BagManager) и выберите метод начисления.
Track B — Подключение компонента к готовому UI
- Выберите существующую кнопку покупки в вашем проекте (сохраняя анимации и материалы).
- Нажмите Add Component →
TelegramStarsButton. - Удалите функцию выдачи из Button OnClick и привяжите её к слоту
OnPurchaseSuccessкомпонентаTelegramStarsButton.
Логика работы: При нажатии компонент автоматически:
- Запрашивает ссылку на счёт через Cloudflare Worker из Шага 2
- Открывает нативное окно оплаты Telegram
- Вызывает функцию выдачи после подтверждения платежа
Справка по демо
Ознакомьтесь с реализацией демо в Packages/com.fasttma.core/Samples/03_StarsPayment.