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.
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.
Related pages
Pronto a ordinare?
Accedi con Telegram — il tuo saldo StarKerak funziona sul sito, nella WebApp e tramite l'API.
