Gift Card API
Продавайте подарочные карты и игровые пополнения из своего бота или магазина — один каталог, один POST, код через API.
Gift Card API от TGTools даёт вашему боту, магазину или платформе оптовый каталог подарочных карт и игровых пополнений за одним REST-ключом. GET /api/catalog выводит товары по категориям — подарочные карты Steam, Apple, PlayStation, Amazon и пополнения вроде PUBG Mobile и Free Fire — с региональными вариантами, розничной ценой в USD и актуальными ценами в TON, и не требует авторизации. GET /api/catalog/item возвращает один товар со всеми номиналами. Для заказа отправьте POST /api/catalog/buy с productId, quantity и, для игровых пополнений, playerId; заказ обрабатывается автоматически, а GET /api/catalog/orders/{id} возвращает deliveryCode после завершения. У пополнения кошелька Steam свои эндпоинты под /api/steam-topup с актуальными курсами и расчётом. Ключи создаются самостоятельно в панели, подписки нет, заказы оплачиваются с баланса кошелька.
Превью эндпоинтов API
Бесплатный API-ключ · без KYCВерификация личности не нужна — зарегистрируйтесь, создайте API-ключ и отправляйте заказы за минуты.
Доступ к API бесплатный. Вы платите только за звёзды, Премиум или NFT с баланса TON-кошелька.
Авторизация: X-Api-Key: tgt_… или Authorization: Bearer tgt_…
Базовый URL: https://api.tg-tools.shopЗвёзды и Премиум Телеграм (Fragment)
- POST
/api/purchase/starsКупить звёзды Телеграм для любого username — мгновенно через Fragment.
- POST
/api/purchase/premiumПодарить Премиум (3, 6 или 12 месяцев) программно.
- GET
/api/purchase/pricesPublicАктуальные цены звёзд и Премиума в TON.
- GET
/api/purchase/user/{username}Проверить пользователя Телеграм перед заказом.
NFT-подарки и маркетплейс
- POST
/api/marketplace/buy/autoАвтопокупка NFT-подарка и доставка на TON-кошелёк.
- GET
/api/marketplace/collectionsКоллекции NFT, supply и floor price.
- GET
/api/marketplace/nft?address=…Детали NFT, статус продажи и цена.
- GET
/api/marketplace/quote?address=…Котировка покупки с комиссией.
Кошелёк и заказы
- GET
/api/walletБаланс TON и адрес для депозита.
- GET
/api/transactionИстория заказов звёзд, Премиума и NFT.
- GET
/api/marketplace/orders/{id}Статус заказа на покупку NFT.
Почему TGTools
- Публичный каталог — GET /api/catalog и /api/catalog/item без ключа
- Подарочные карты и игровые пополнения с региональными вариантами и живыми ценами в TON
- Один POST для заказа, код доставки возвращается через API
- Пополнение кошелька Steam по актуальным курсам через /api/steam-topup
- Самостоятельный API-ключ, без подписки
- Тот же ключ покрывает звёзды, Премиум и подарки Telegram
Возможности платформы
- GET /api/catalog?category=giftcards|topups&q=… — товары постранично с вариантами
- GET /api/catalog/item?key=giftcards:amazon — один товар, все номиналы
- POST /api/catalog/buy — { productId, quantity, playerId? }
- GET /api/catalog/orders и /api/catalog/orders/{id} — статус и deliveryCode
- GET /api/steam-topup/rates и /quote — цены пополнения Steam
- POST /api/steam-topup/buy — { steamLogin, currency, amount }
Как это работает
- 1
Получите API-ключ
Создайте аккаунт и сгенерируйте API-ключ в панели.
- 2
Интеграция
Используйте REST API — или панель — для покупки звёзд и Премиума.
- 3
Мониторинг
Отслеживайте каждый заказ, баланс кошелька и историю в реальном времени.
Частые вопросы
Какие подарочные карты можно купить через API?
Всё, что есть в живом каталоге: GET /api/catalog?category=giftcards возвращает региональные карты (Steam, Apple, PlayStation, Amazon и другие) с номиналами и текущими ценами.
Как доставляется подарочная карта?
После POST /api/catalog/buy заказ обрабатывается автоматически; опрашивайте GET /api/catalog/orders/{id} — поле deliveryCode заполняется, когда статус становится Completed.
Можно ли покупать игровые пополнения?
Да. Используйте category=topups; у товаров, которым нужен аккаунт игрока, установлен requiresPlayerId, а playerId передаётся в запросе покупки.
Нужен ли аккаунт, чтобы читать каталог?
Нет. Эндпоинты каталога и товара публичные; API-ключ нужен только для /api/catalog/buy и истории заказов.
Как оплачиваются заказы?
С баланса кошелька TGTools в TON. Цены каталога актуальные, подписки и платы за запрос нет.
Как получить ключ Gift Card API?
Создайте бесплатный аккаунт, откройте Настройки → API-ключи и сгенерируйте ключ (до пяти). Документация: /api-docs.
Готовы начать?
Регистрация за секунды. Без скрытых комиссий. Мгновенная доставка.
