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 Auszahlungen 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 nach ihrer Bestätigung aus ihrem Guthaben bezahlen.
Was du damit machen kannst
- Rechnungen – erstelle eine Zahlungsanfrage (ein fester Krypto-Betrag, ein in Fiat angegebener oder ein freier Betrag, den der Zahler selbst wählt), schicke dem Zahler ihren Link und erhalte nach der Zahlung einen signierten Webhook, sofern eine Webhook-URL eingerichtet ist.
- 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 – finanziere einlösbare Links aus deinem App-Guthaben: für beliebige oder namentlich festgelegte Empfänger, entsprechend deinen Auszahlungseinstellungen.
- 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.
- Unterstützte Zahlungsereignisse können als signierter Webhook an deinen Server geschickt werden, wenn du URL und Ereignisabonnements einrichtest.
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, wenn diese Option verfügbar ist. Die Einzahlung
geht in seine eigene Wallet. Für die automatische Zahlung sind außerdem
ausreichendes Guthaben, keine Einschränkung ausgehender Zahlungen und eine
gültige Zahlungsfrist nötig. Prüfe auf deiner Seite vor der Lieferung den
Rechnungsstatus paid.
Kompatibel mit Crypto Bot
Die API bildet die von Crypto Bot bewusst nach: dieselben Methodennamen,
dieselbe {ok, result}-Struktur, dieselben Beträge als Dezimalstrings, dasselbe
Verfahren für Webhook-Signaturen. Um eine bestehende Integration anzupassen,
ändere Basis-URL und Token und teste die verwendeten Methoden anhand unserer
Referenz.
Wie Crypto Bot betreiben wir ein Testnet
mit eigenem Bot und eigener Basis-URL.
Der kanonische Token-Header ist TgPayCrypto-API-Token; der frühere Name
TgCryptoPay-API-Token (bis 2026-09-07) funktioniert weiterhin, und
Crypto-Pay-API-Token wird als Alias akzeptiert, damit bestehende
Client-Bibliotheken unverändert weiterlaufen.
⚠️ Dein API-Token ist ein Schlüssel zum Geldausgeben
Ein Haupt-Token erlaubt Auszahlungen im Rahmen des Auszahlungsmodus und der Limits deiner App. 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.