SMM API для реселлеров: как запустить свой магазин услуг через TGLift

API TGLift подходит агентствам, владельцам SMM-панелей, разработчикам и предпринимателям, которые хотят продавать услуги продвижения через собственный интерфейс. Вместо ручного переноса каждого заказа ваш сервер получает каталог, создает заказы, проверяет их состояние и показывает клиенту результат автоматически.

В публичной интеграции TGLift выступает поставщиком услуг для вашего аккаунта. Ваш покупатель работает с вашим сайтом, приложением или ботом, а обмен с TGLift выполняется на серверной стороне. API использует услуги, цены, номера заказов и статусы TGLift; внутренние процессы обработки не входят в публичный контракт.

Открыть API TGLift →

Что можно запустить через SMM API

Один API можно использовать как основу для разных продуктов. Вы выбираете формат, аудиторию и собственную розничную модель:

• собственный SMM-магазин с каталогом, поиском, фильтрами, балансом и историей заказов;
• Telegram-бот или Mini App для заказа услуг внутри Telegram;
• панель агентства для менеджеров и постоянных клиентов;
• внутреннюю CRM-интеграцию для автоматической передачи заказов;
• узкий нишевой сервис, например только для Telegram, TikTok или Instagram.

Два варианта запуска

1. Самостоятельная интеграция

Если у вас есть разработчик, используйте документацию API TGLift и спецификацию OpenAPI 3.1. Вы сами создаете интерфейс, определяете категории, настраиваете свою наценку и подключаете методы заказов к серверной части проекта.

2. Магазин под ключ от TGLift

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

Состав функций, дизайн, платежные методы, сроки и стоимость определяются после обсуждения задачи. Такой вариант подходит, когда нужен не только API-ключ, а готовый рабочий магазин под вашим брендом.

Какие данные предоставляет API TGLift

Актуальный REST-контракт закрывает полный базовый цикл работы реселлера:

• GET /api/v1/services возвращает доступные услуги TGLift, категории, публичные цены, валюту, лимиты, описание и обязательные параметры заказа.
• GET /api/v1/balance возвращает доступный баланс аккаунта.
• POST /api/v1/orders проверяет параметры, списывает средства и создает заказ.
• GET /api/v1/orders возвращает историю заказов с пагинацией.
• GET /api/v1/orders/{RQ-ID} возвращает статус, остаток, начальное значение, сумму и возврат по конкретному заказу.
• POST /api/v1/orders/{RQ-ID}/cancel отправляет запрос отмены, если она доступна для услуги.
• POST /api/v1/orders/{RQ-ID}/refill отправляет запрос гарантийного восстановления, если услуга поддерживает refill.

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

Как выглядит рабочая интеграция

1. Зарегистрируйте аккаунт TGLift и пополните его баланс.
2. Откройте раздел API и выпустите секретный ключ.
3. Загрузите каталог и сохраните ID выбранных услуг вместе с лимитами и требованиями.
4. Покажите услуги в своем интерфейсе и примените собственную розничную наценку.
5. Перед созданием заказа проверьте ссылку, количество, дополнительные поля и баланс.
6. Отправьте заказ с заголовками X-API-Key и Idempotency-Key.
7. Сохраните полученный номер заказа TGLift формата RQ и регулярно обновляйте его статус.
8. Показывайте клиенту остаток, возврат и итоговое состояние из ответа API.

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

Своя наценка и экономика магазина

API возвращает публичную стоимость TGLift в выбранной валюте. В своем магазине вы можете добавить собственную наценку: общую, по платформе, категории, диапазону стоимости или конкретной услуге. Конечную цену для покупателя рассчитывает ваш проект.

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

Статусы, отмены и возвраты

Успешный ответ на создание означает, что заказ принят TGLift, но не означает его моментальное завершение. В интеграции нужно обрабатывать очередь, выполнение, частичное выполнение, отмену, ошибку и проверку результата.

Для каждого заказа API возвращает унифицированный статус. При частичном выполнении или отмене используйте поле refundedAmount, а не рассчитывайте возврат по предположениям. Возможность отмены и refill зависит от условий конкретной услуги и указывается в каталоге.

Безопасность API-ключа

Секретный ключ должен храниться только на вашем сервере. Не вставляйте его в JavaScript браузера, мобильное приложение, публичный репозиторий, URL или скриншоты. Все запросы к TGLift должен выполнять ваш backend.

• передавайте ключ только в заголовке X-API-Key;
• используйте отдельный Idempotency-Key для каждой новой попытки заказа;
• обрабатывайте HTTP-коды 400, 401, 402, 404, 409, 422, 429 и 5xx;
• сохраняйте requestId из ошибки для обращения в поддержку;
• отзывайте ключ и выпускайте новый, если есть риск компрометации.

Частые вопросы

Покупатель увидит TGLift?

При правильной серверной интеграции покупатель работает только с интерфейсом вашего проекта. Он не получает API-ключ и не обращается к TGLift напрямую. Ваш аккаунт TGLift остается поставщиком для вашего магазина.

Можно ли продавать услуги со своей наценкой?

Да. API возвращает стоимость TGLift, а розничную цену и правила наценки вы определяете в своем проекте.

Нужно ли вручную обновлять каталог?

Лучше синхронизировать услуги регулярно. Цена, лимиты, описание и доступность могут меняться, поэтому перед созданием заказа используйте актуальные данные.

Можно ли начать без разработчика?

Да. Вы можете сначала работать через обычный кабинет TGLift, а затем заказать магазин под ключ и перенести продажи в собственный интерфейс.

Начните интеграцию

Откройте документацию API TGLift, зарегистрируйте аккаунт и получите ключ. Если нужен готовый магазин, оставьте обращение в разделе поддержки с описанием проекта, платформ, платежных методов и желаемого функционала.