TgPay Crypto
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 Auszahlungen 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
Verbinde einen KI-Coding-Agenten, der entfernte MCP-Server unterstützt, mit https://app.tgpaycrypto.com/mcp. Er kann die API-Dokumentation lesen, eine Händler-App anfordern, Webhooks einrichten und dir beim Integrationscode helfen. Du bestätigst die App-Erstellung im Bot; der Agent erhält einen eingeschränkten Token, ohne dass du ihn von Hand kopieren musst. Prüfe und teste die Integration, bevor du echte Zahlungen annimmst.
Zahlungen mit Rechnungen annehmen
Mit einer Rechnung forderst du einen Telegram-Nutzer zur Zahlung auf. Du erstellst sie über die API und schickst dem Zahler ihren Link. Eine erfolgreiche Zahlung wird deinem App-Guthaben abzüglich der Händlergebühr gutgeschrieben.
Gebühren und Limits bei der Händler-API
Auf Rechnungen fällt eine Plattformgebühr an, die von deinem Zahlungseingang abgezogen wird; Ü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
Hier findest du die gemeinsamen Konventionen aller Methoden und die lesenden Katalogmethoden. Die einzelnen Methoden sind auf diesen Seiten beschrieben: 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, Antwortformat, 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
Mit diesen Methoden zahlst du Guthaben aus deiner App aus. Eine Überweisung sendet es in die Wallet eines Telegram-Nutzers oder hält es zurück, bis ein neuer Empfänger den Bot öffnet. Ein Scheck ist ein einlösbarer Link, dessen Betrag du im Voraus bereitstellst. Die allgemeinen Regeln (Authentifizierung, Antwortformat, 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 an deinen Server, nachdem sie eingetreten sind. Trage unter Mehr → Händler-API im Feld Webhook-URL (optional) die URL deiner App ein; die Plattform sendet dann für jedes Ereignis, das du abonniert hast, per POST einen signierten JSON-Body.
Bedingungen der Händler-API
Diese Bedingungen gelten für die Händler-API – Apps, API-Token, Rechnungen, Abos, Überweisungen, Schecks, Webhooks und die Anbindung von KI-Agenten. Sie gelten zusätzlich zu den allgemeinen Nutzungsbedingungen der App und ihrer AML-Richtlinie. Mit dem Erstellen einer App akzeptierst du sie; nutzt du eine App weiter, die vor dem 7. September 2026 erstellt wurde, akzeptierst du sie ebenfalls.
Noch Fragen? Schreib dem Support.
Du kannst dem Support jederzeit auf Telegram schreiben. Niemand vom Support fragt dich jemals nach deiner PIN oder einem Code aus deiner E-Mail.