PayStars API für Entwickler: der komplette Ablauf zum Verkauf von Stars und Premium in Ihrem Bot
So funktioniert die PayStars REST API von Anfang bis Ende: X-API-Key, Prüfungen von Benutzernamen, USD-Angebote mit max_usd, idempotente Bestellungen, der Fehler 409 price_changed und die TxId-Prüfung als Integrationsplan.
Veröffentlicht: · Aktualisiert:

Möchten Sie Telegram Stars und Premium in Ihrem eigenen Bot, Shop oder Ihrer App verkaufen? Die PayStars API bietet Ihnen eine HTTPS-Schnittstelle und ein USD-Guthaben, das mit der Website geteilt wird. Anstatt die API-Referenz zu wiederholen, zeigt dieser Artikel, wie Sie die Integration von Anfang bis Ende aufbauen.
Die Architektur auf einen Blick
Ihr System erledigt drei Dinge: Es lädt das Guthaben mit USDT auf, fragt einen Preis ab und erstellt eine Bestellung. Alles andere, einschließlich der Zustellung über den offiziellen Kaufablauf von Telegram, erfolgt auf der PayStars-Seite.
| Teil | Funktion |
|---|---|
| Zugriff | Header X-API-Key; Schlüssel werden im Dashboard erstellt |
| Guthaben | USD, aufgeladen mit USDT (TON, BEP20 oder TRC20) |
| Preis | Fragment-Preis × 1,05, auf den Cent aufgerundet |
| Limit | 10 Anfragen pro Sekunde und Schlüssel |
| Transparenz | Eine öffentliche TxId für jede abgeschlossene Bestellung |
Stufe 1: Guthaben aufladen
POST /usd/invoice mit einem Betrag und einer Chain ("ton", "bsc" oder "trc20") liefert einen genauen Betrag, der 30 Minuten gültig ist. Das Minimum beträgt 0,1 USDT.
Stufe 2: Empfänger prüfen
POST /api/v1/check-username prüft den Empfänger und gibt ein kurzlebiges Verifizierungstoken zurück. Das verhindert Zahlungen an Benutzernamen, die nicht existieren: Macht ein Kunde einen Tippfehler, erfahren Sie das, bevor etwas berechnet wird.
Stufe 3: Preis abrufen und begrenzen
POST /api/v1/usd/quote gibt den aktuellen Preis (usd) und den Aufschlag (markup_percent: 5) zurück. Der Preis folgt dem Markt, daher:
- fordern Sie vor jeder Bestellung ein frisches Angebot an;
- übergeben Sie max_usd in Höhe des angebotenen Betrags;
- senden Sie immer currency: "USD", sonst wird die gespeicherte Präferenz des Kontos verwendet.
Stufe 4: Bestellung erstellen
POST /api/v1/stars/buy oder /api/v1/premium/buy. Jede Anfrage muss einen Idempotency-Key enthalten, damit Sie bei einem Verbindungsabbruch und einem erneuten Versuch nicht zweimal belastet werden. Speichern Sie den Schlüssel zusammen mit der Bestell-ID in Ihrer Datenbank.
Stufe 5: Status verfolgen
GET /api/v1/order/{id} und /api/v1/orders liefern Status und Verlauf. Die meisten Bestellungen werden innerhalb von Minuten zugestellt. Eine abgeschlossene Bestellung erhält eine TxId, die Sie und Ihr Kunde im öffentlichen Ledger von PayStars prüfen können.
Fehler richtig behandeln
- 409 price_changed bedeutet, dass der Preis über max_usd gestiegen ist und nichts berechnet wurde. Holen Sie ein neues Angebot und zeigen Sie dem Kunden den aktualisierten Preis.
- Ratenlimit: Überschreiten Sie nicht 10 Anfragen pro Sekunde; fügen Sie eine Warteschlange oder ein Backoff hinzu.
- Wiederholungen: Verwenden Sie immer denselben Idempotency-Key.
Vor dem Livegang
- Bewahren Sie den API-Schlüssel in einer Server-Umgebungsvariable auf, nicht im Code.
- Führen Sie den gesamten Ablauf mit einer kleinen echten Bestellung von 50 Stars aus.
- Zeigen Sie Kunden ihre TxId, das schafft Vertrauen.
Vollständige Dokumentation und Schnellstarts: PayStars Stars API und USD-Preise für die API. Für Zahlungen im Bot siehe digitale Güter in Bots werden nur in Stars bezahlt.
Häufige Fragen
Gibt es eine Sandbox?
Es gibt keine separate Sandbox; testen Sie bei der Integration mit kleinen echten Bestellungen (50 Stars).
Welche Programmiersprachen funktionieren?
Jede Sprache, die HTTPS-Anfragen senden kann. Es gibt Schnellstarts für Python, Node.js und PHP.
Wie lade ich das Guthaben auf?
Mit USDT über TON, BEP20 oder TRC20, mindestens 0,1 USDT; jede Rechnung hat einen genauen Betrag, der 30 Minuten gültig ist.
Quellen
Related pages
Stars und Premium mit USD (USDT) kaufen
Per API-Schlüssel: reiner Fragment-Preis, 0 % (Website: 5 %).
More news
Telegram Stars und Premium in Usbekistan: per Karte oder mit USDT zahlenTelegram Stars oder Premium in Usbekistan kaufen: Uzcard und Humo über @StarKerakBot, USDT auf paystars.uz/uz/, die offiziellen Wege in der App und die lokalen Regeln, die Sie kennen sollten.Lesen →
So belohnen Sie Wettbewerbsgewinner mit Telegram Stars oder Premium: ein Leitfaden für VeranstalterTelegram Stars oder Premium an die Gewinner Ihres eigenen Quiz, Wettbewerbs oder Hackathons übergeben: Budget, @usernames erfassen, Zustellung über PayStars und ein Abschlussbericht.Lesen →
PayStars FAQ: häufige Fragen zu Anmeldung, USDT-Aufladungen sowie Stars- und Premium-BestellungenDie häufigsten PayStars-Fragen auf einer Seite: Anmeldung mit Telegram, Aufladen mit USDT (TON, BEP20 oder TRC20), Bestellung von Stars und Premium, Lieferzeiten, Sicherheit und die API.Lesen →