Telegram Stars API
Vendez des Telegram Stars et Premium dans votre propre bot, boutique ou application. Une API HTTPS, un solde partagé avec le bot StarKerak et le site.
Ce que fait l'API
- POST /api/v1/check-username — vérifier un destinataire et obtenir un jeton de vérification de courte durée
- POST /api/v1/stars/buy et /api/v1/premium/buy — créer des commandes (Idempotency-Key requis)
- GET /api/v1/order/{id} et /api/v1/orders — statuts et historique
- GET /api/v1/prices, /api/v1/account, portefeuille USD et factures USDT
L'authentification utilise un en-tête X-API-Key. Les clés sont créées dans le tableau de bord et n'expirent pas tant que vous ne les révoquez pas.
Conçu pour la production
Chaque commande porte votre Idempotency-Key : les nouvelles tentatives ne débitent donc jamais deux fois. La vérification du destinataire empêche les paiements vers des noms d'utilisateur inexistants. La limite est de 10 requêtes par seconde et par clé.
Toutes les commandes sont payées depuis le solde USD (currency=USD ; UZS est traité comme USD). Indiquez max_usd pour plafonner le prix que vous acceptez.
Transparence
Chaque commande terminée reçoit un TxId enregistré sur le registre public de PayStars, afin que vous et vos clients puissiez vérifier la livraison de façon indépendante.
Prix Fragment, sans marge
Les commandes par clé API depuis le solde USD sont facturées au prix Fragment en direct 0 % (site : 5 %) ; les commandes du site et de la mini-application affichent le montant exact avant le paiement. Obtenez le prix avec POST /usd/quote et plafonnez-le avec max_usd. Détails sur la page de l'API Fragment.
Questions fréquentes
Existe-t-il un bac à sable ?
Utilisez de petites commandes réelles (50 Stars) pendant l'intégration ; la clé d'idempotence rend les nouvelles tentatives sûres.
Quels langages sont pris en charge ?
Tout langage avec HTTPS. Voir les guides de démarrage Python, Node.js et PHP.
Les clés API expirent-elles ?
Non. Les clés restent valides jusqu'à ce que vous les révoquiez dans le tableau de bord.
Puis-je payer en USD ?
Oui — rechargez le solde USD avec des USDT (TON, BEP20 ou TRC20) et envoyez currency=USD.
Related pages
Prêt à commander ?
Connectez-vous avec Telegram — votre solde StarKerak fonctionne sur le site, dans la WebApp et via l'API.
