Telegram Stars API
Verkaufen Sie Telegram Stars und Premium in Ihrem eigenen Bot, Shop oder Ihrer App. Eine HTTPS-API, ein Guthaben gemeinsam mit dem StarKerak-Bot und der Website.
Was die API leistet
- POST /api/v1/check-username — Empfänger prüfen und ein kurzlebiges Verifizierungstoken erhalten
- POST /api/v1/stars/buy und /api/v1/premium/buy — Bestellungen erstellen (Idempotency-Key erforderlich)
- GET /api/v1/order/{id} und /api/v1/orders — Status und Verlauf
- GET /api/v1/prices, /api/v1/account, USD-Wallet und USDT-Rechnungen
Die Authentifizierung erfolgt über einen X-API-Key-Header. Schlüssel werden in der Übersicht erstellt und verfallen erst, wenn Sie sie widerrufen.
Für den Produktivbetrieb entwickelt
Jede Bestellung trägt Ihren Idempotency-Key, sodass Wiederholungen nie doppelt abbuchen. Die Empfängerprüfung verhindert Zahlungen an nicht vorhandene Benutzernamen. Das Ratenlimit beträgt 10 Anfragen pro Sekunde und Schlüssel.
Alle Bestellungen werden vom USD-Guthaben bezahlt (currency=USD; UZS wird als USD behandelt). Übergeben Sie max_usd, um den Preis zu begrenzen, den Sie akzeptieren.
Transparenz
Jede abgeschlossene Bestellung erhält eine TxId, die im öffentlichen PayStars-Hauptbuch erfasst wird, sodass Sie und Ihre Kunden die Lieferung unabhängig prüfen können.
Fragment-Preis, 0 % (Website: 5 %)
Bestellungen per API-Schlüssel vom USD-Guthaben werden zum aktuellen Fragment-Preis 0 % (Website: 5 %) berechnet; Preis abrufen mit POST /usd/quote und mit max_usd begrenzen. Details auf der Seite zur Fragment-API.
Häufig gestellte Fragen
Gibt es eine Testumgebung?
Nutzen Sie beim Integrieren kleine echte Bestellungen (50 Stars); der Idempotenzschlüssel macht Wiederholungen sicher.
Welche Sprachen werden unterstützt?
Jede Sprache mit HTTPS. Siehe die Schnellstarts für Python, Node.js und PHP.
Verfallen API-Schlüssel?
Nein. Schlüssel bleiben gültig, bis Sie sie in der Übersicht widerrufen.
Kann ich in USD zahlen?
Ja — laden Sie das USD-Guthaben mit USDT (TON, BEP20 oder TRC20) auf und senden Sie currency=USD.
Related pages
Bereit zur Bestellung?
Mit Telegram anmelden — Ihr StarKerak-Guthaben gilt auf der Webseite, in der WebApp und über die API.
