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.
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.
Related pages
Pronto para pedir?
Entre com o Telegram — seu saldo StarKerak funciona no site, no WebApp e pela API.
