Anleitung · PayStars

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:

PayStars API für Entwickler: der komplette Ablauf zum Verkauf von Stars und Premium in Ihrem Bot

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.

TeilFunktion
ZugriffHeader X-API-Key; Schlüssel werden im Dashboard erstellt
GuthabenUSD, aufgeladen mit USDT (TON, BEP20 oder TRC20)
PreisFragment-Preis × 1,05, auf den Cent aufgerundet
Limit10 Anfragen pro Sekunde und Schlüssel
TransparenzEine ö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

  1. Bewahren Sie den API-Schlüssel in einer Server-Umgebungsvariable auf, nicht im Code.
  2. Führen Sie den gesamten Ablauf mit einer kleinen echten Bestellung von 50 Stars aus.
  3. 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

Stars und Premium mit USD (USDT) kaufen

Per API-Schlüssel: reiner Fragment-Preis, 0 % (Website: 5 %).

Jetzt starten