Was ist die Händler-API?
Die Händler-API ist die Zahlungsschnittstelle der App für Unternehmen und Bots. Du erstellst eine App, erhältst einen API-Token und stellst damit Telegram-Nutzern Rechnungen, schickst ihnen Ausschüttungen und rufst dein Guthaben ab – alles aus deinem eigenen Code.
Es ist die Entwicklerseite desselben Produkts, das Nutzer sehen: Eine Rechnung, die du über die API erstellst, ist die Rechnung, die sie mit einem Tippen aus ihrem Guthaben bezahlen.
Was du damit machen kannst
- Rechnungen – erstelle eine Zahlungsanfrage (ein fester Krypto-Betrag, ein in Fiat ausgepreister oder ein freier Betrag, den der Zahler selbst wählt), schicke dem Zahler ihren Link und erhalte im Moment der Zahlung einen signierten Callback.
- Rückerstattungen – gib den Betrag einer bezahlten Rechnung ganz oder teilweise an den zurück, der sie bezahlt hat – auch an anonyme Zahler.
- Überweisungen – sende Krypto aus deinem App-Guthaben an einen Telegram-Nutzer, einzeln oder bis zu 100 in einem Stapel.
- Schecks – stelle aus deinem App-Guthaben einlösbare Links aus, die jeder einlösen kann.
- Abos – wiederkehrende Abrechnung: Nutzer stimmen einem Plan einmal zu, und danach wird ihr Guthaben in jedem Zeitraum automatisch belastet.
- Guthaben, Währungen, Wechselkurse und Statistiken – Endpunkte nur zum Lesen für deine eigene Buchhaltung.
Wie alles zusammenspielt
- Deine App hat ein eigenes Guthaben, getrennt von deiner persönlichen Wallet.
- Rechnungen, die Nutzer bezahlen, werden diesem App-Guthaben gutgeschrieben.
- Überweisungen und Schecks werden davon abgebucht.
- Jedes wichtige Ereignis kann als signierter Webhook an deinen Server geschickt werden.
Zahlungen werden innerhalb der App abgewickelt, nicht on-chain: keine Netzwerkgebühr, keine Bestätigungen, auf die du warten musst, und das Guthaben ist nutzbar, sobald es eingeht. Ein Zahler kann eine Rechnung trotzdem aus einer externen Wallet finanzieren – seine Einzahlung landet in seiner eigenen Wallet und die Rechnung wird daraus automatisch beglichen; auf deiner Seite sieht das genauso aus wie jede andere bezahlte Rechnung.
Kompatibel mit Crypto Bot
Die API bildet die von Crypto Bot bewusst nach: dieselben Methodennamen,
dieselbe {ok, result}-Hülle, dieselben Beträge als Dezimalstrings, dasselbe
Verfahren für Webhook-Signaturen. Du kannst eine bestehende
Crypto-Bot-Integration auf uns umstellen, indem du nur die Basis-URL und den
Token änderst – an den Formaten von Anfrage und Antwort ändert sich nichts.
Der kanonische Token-Header ist TgPayCrypto-API-Token; Crypto-Pay-API-Token
wird als Alias akzeptiert, damit bestehende Client-Bibliotheken unverändert
weiterlaufen.
⚠️ Dein API-Token ist ein Schlüssel zum Geldausgeben
Wer ihn besitzt, kann das Guthaben deiner App abfließen lassen. Bewahre ihn serverseitig auf, halte ihn aus Client-Apps und Repositorys heraus und erneuere ihn, sobald du vermutest, dass er nach außen gelangt ist. Für Server, die keinen vollen Zugriff brauchen, erstellst du einen eingeschränkten Token, der nur auf die Berechtigungen begrenzt ist, die sie tatsächlich nutzen – siehe die API-Referenz.
Weiter
War dieser Artikel hilfreich?
Danke für dein Feedback.