TG Crypto Pay
Händler-API (für Entwickler)
Die Händler-API: Apps, Rechnungen, Überweisungen und Webhooks.
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.
Erste Schritte als Entwickler
Erstelle eine App in der Mini App, kopiere ihren API-Token einmalig und beginne, die API aufzurufen. Die gesamte Einrichtung liegt unter Mehr → Händler-API.
KI-Agent verbinden
Gib deinem Coding-Agenten eine einzige URL – https://crypto.tgpaybot.com/mcp – und er baut die Zahlungsanbindung für dich: Er liest die API-Doku, erstellt deine Händler-App, richtet die Webhooks ein und schreibt den Code. Du bestätigst die neue App ein einziges Mal, mit einem Tippen im Bot. Ein Terminal brauchst du dafür nicht, und einen API-Token musst du auch nicht von Hand kopieren.
Zahlungen mit Rechnungen annehmen
Mit einer Rechnung stellst du einem Telegram-Nutzer einen Betrag in Rechnung. Du erstellst sie über die API, schickst dem Zahler ihren Link, und der Betrag wird deinem App-Guthaben in dem Moment gutgeschrieben, in dem die Zahlung bestätigt ist.
Gebühren und Limits bei der Händler-API
Auf Rechnungen fällt eine Plattformgebühr an, die von dem abgeht, was du erhältst; Überweisungen und Schecks sind durch Betragslimits begrenzt. Die Zahlen unten sind die aktuellen Einstellungen, keine Vertragsbedingungen – wenn sie von dem abweichen, was du siehst, gilt die App, und die verlässliche Quelle sind immer deine eigenen bezahlten Rechnungen.
Händler-API-Referenz
Die Konventionen, die alle Methoden teilen, plus die Katalogmethoden nur zum Lesen. Seiten Methode für Methode: Rechnungen und Rückerstattungen, Überweisungen und Schecks, Abos, Webhooks.
API-Referenz: Rechnungen und Rückerstattungen
Die Methoden rund um Rechnungen: createInvoice, getInvoices, deleteInvoice, refundInvoice. Die Konventionen (Authentifizierung, Hülle, Beträge, spend_id) stehen auf der Seite Händler-API-Referenz; die geführte Anleitung ist Zahlungen mit Rechnungen annehmen.
API-Referenz: Überweisungen und Schecks
Die Methoden für Ausschüttungen. Eine Überweisung bewegt Guthaben aus deiner App direkt in die Wallet eines Telegram-Nutzers; ein Scheck ist ein einlösbarer Link, den du im Voraus finanzierst. Die Konventionen (Authentifizierung, Hülle, Beträge, spend_id) stehen auf der Seite Händler-API-Referenz.
API-Referenz: Abos
Wiederkehrende Abrechnung – eine Erweiterung gegenüber Crypto Bot. Du erstellst einen Plan (Betrag + Zeitraum), schickst Nutzern seinen Zustimmungslink, und die Plattform bucht ihnen in jedem Zeitraum den Betrag vom Guthaben ihrer Wallet ab und schreibt ihn abzüglich der Gebühr deinem App-Guthaben gut. Die Konventionen stehen auf der Seite Händler-API-Referenz.
API-Referenz: Webhooks
Webhooks schicken Ereignisse in dem Moment an deinen Server, in dem sie passieren. Lege die Webhook-URL deiner App unter Mehr → Händler-API fest; die Plattform sendet dann für jedes Ereignis, das du abonniert hast, per POST einen signierten JSON-Body.
Nicht weitergekommen? Sprich mit einem Menschen.
Der Support antwortet rund um die Uhr in Telegram. Niemand vom Support fragt dich jemals nach deiner PIN oder einem Code aus deiner E-Mail.