★ Para desenvolvedores

Telegram Stars API

Venda Telegram Stars e Premium no seu próprio bot, loja ou app. Uma API HTTPS, um saldo compartilhado com o bot StarKerak e o site.

Entrega automáticaa maioria dos pedidos em minutos
Verificação de nome de usuárioantes de pagar
Preços abertosiguais no site e na API
Registro públicotodo pedido recebe um TxId

O que a API faz

  • POST /api/v1/check-username — verifique um destinatário e obtenha um token de verificação de curta duração
  • POST /api/v1/stars/buy e /api/v1/premium/buy — crie pedidos (Idempotency-Key obrigatória)
  • GET /api/v1/order/{id} e /api/v1/orders — status e histórico
  • GET /api/v1/prices, /api/v1/account, carteira em USD e faturas em USDT

A autenticação usa o cabeçalho X-API-Key. As chaves são criadas no painel e não expiram até que você as revogue.

Feito para produção

Cada pedido leva a sua Idempotency-Key, então novas tentativas nunca cobram em dobro. A verificação do destinatário impede pagamentos para nomes de usuário inexistentes. O limite é de 10 solicitações por segundo por chave.

Todos os pedidos são pagos com o saldo em USD (currency=USD; UZS é tratado como USD). Envie max_usd para limitar o preço que você aceita.

Transparência

Cada pedido concluído recebe um TxId registrado no livro-razão público da PayStars, para que você e seus clientes possam verificar a entrega de forma independente.

Preço do Fragment, 0% (site: 5%)

Pedidos com chave de API a partir do saldo em USD são cobrados pelo preço ao vivo do Fragment 0% (site: 5%); o valor exato é mostrado antes do pagamento. Obtenha o preço com POST /usd/quote e limite-o com max_usd. Detalhes na página da API do Fragment.

Perguntas frequentes

Existe um ambiente de testes?

Use pedidos reais pequenos (50 Stars) durante a integração; a chave de idempotência torna as novas tentativas seguras.

Quais linguagens são compatíveis?

Qualquer linguagem com HTTPS. Veja os guias rápidos de Python, Node.js e PHP.

As chaves de API expiram?

Não. As chaves permanecem válidas até que você as revogue no painel.

Posso pagar em USD?

Sim — recarregue o saldo em USD com USDT (TON, BEP20 ou TRC20) e envie currency=USD.

Pronto para pedir?

Entre com o Telegram — seu saldo StarKerak funciona no site, no WebApp e pela API.