Для разработчиков и продавцов

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-ключ и отправляйте заказы за минуты.

Доступ к 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. 1

    Получите API-ключ

    Создайте аккаунт и сгенерируйте API-ключ в панели.

  2. 2

    Интеграция

    Используйте REST API — или панель — для покупки звёзд и Премиума.

  3. 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.

Готовы начать?

Регистрация за секунды. Без скрытых комиссий. Мгновенная доставка.