★ Per gli sviluppatori

Telegram Stars API

Vendi Telegram Stars e Premium nel tuo bot, negozio o app. Una sola API HTTPS, un saldo condiviso con il bot StarKerak e il sito.

Consegna automaticala maggior parte degli ordini in pochi minuti
Controllo del nome utenteprima del pagamento
Prezzi pubblicigli stessi sul sito e via API
Registro pubblicoogni ordine riceve un TxId

Cosa fa l'API

  • POST /api/v1/check-username — verifica un destinatario e ottieni un token di verifica a breve durata
  • POST /api/v1/stars/buy e /api/v1/premium/buy — crea ordini (Idempotency-Key obbligatorio)
  • GET /api/v1/order/{id} e /api/v1/orders — stati e cronologia
  • GET /api/v1/prices, /api/v1/account, portafoglio USD e fatture USDT

L'autenticazione usa un'intestazione X-API-Key. Le chiavi si creano nel pannello e non scadono finché non le revochi.

Pronto per la produzione

Ogni ordine porta la tua Idempotency-Key, così i tentativi ripetuti non addebitano due volte. Il controllo del destinatario evita pagamenti a username inesistenti. Il limite è di 10 richieste al secondo per chiave.

Tutti gli ordini si pagano dal saldo USD (currency=USD; UZS è trattato come USD). Passa max_usd per limitare il prezzo che accetti.

Trasparenza

Ogni ordine completato riceve un TxId registrato sul registro pubblico di PayStars, così tu e i tuoi clienti potete verificare la consegna in modo indipendente.

Prezzo Fragment, 0% (sito: 5%)

Gli ordini con chiave API dal saldo USD sono al prezzo Fragment in tempo reale 0% (sito: 5%); gli ordini dal sito e dalla Mini App mostrano il totale esatto prima del pagamento. Ottieni il prezzo con POST /usd/quote e limitalo con max_usd. Dettagli nella pagina dell'API Fragment.

Domande frequenti

C'è un ambiente di prova?

Durante l'integrazione usa piccoli ordini reali (50 Stars); la chiave di idempotenza rende sicuri i tentativi ripetuti.

Quali linguaggi sono supportati?

Qualsiasi linguaggio con HTTPS. Vedi le guide rapide per Python, Node.js e PHP.

Le chiavi API scadono?

No. Le chiavi restano valide finché non le revochi nel pannello.

Posso pagare in USD?

Sì — ricarica il saldo USD con USDT (TON, BEP20 o TRC20) e invia currency=USD.

Pronto a ordinare?

Accedi con Telegram — il tuo saldo StarKerak funziona sul sito, nella WebApp e tramite l'API.