★ Für Entwickler

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.

Automatische Lieferungdie meisten Bestellungen in Minuten
Benutzernamenprüfungbevor Sie zahlen
Offene Preisegleich auf Webseite und API
Öffentliches Registerjede Bestellung erhält eine TxId

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.

Bereit zur Bestellung?

Mit Telegram anmelden — Ihr StarKerak-Guthaben gilt auf der Webseite, in der WebApp und über die API.