Händler-API

Zahlungen im eigenen Bot annehmen

Erstelle einen Token, stelle Rechnungen per API aus und verarbeite Zahlungs-Webhooks. Im separaten Testnet kannst du den gesamten Ablauf vor der Veröffentlichung prüfen.

8 Coins · 16 Asset-Netzwerk-Kombinationen · ein Guthaben Integration über den MCP-Server mit deinem KI-Agenten →
Übersicht der API-Token und Webhooks
Webhook zugestellt
Testumgebung
Erste Schritte

Händler-API anbinden

In vier Schritten vom Token zum ersten Webhook. Mehr zur Händler-API →

Schritt 1

Token erstellen

Erstelle eine Anwendung in TgPay und erhalte deinen Token für die Händler-API.

Schritt 2

Rechnung erstellen

Erstelle eine Rechnung per API mit Betrag, Coin und Beschreibung. Die Webhook-Adresse hinterlegst du in den Anwendungseinstellungen.

Schritt 3

Zahlungslink anzeigen

Zeige dem Nutzer einen Link oder eine Schaltfläche. Die Zahlung erfolgt in Telegram.

Schritt 4

Webhook verarbeiten

Verarbeite die Zahlungsbestätigung und liefere die Ware oder erteile den Zugang in deinem Dienst.

KI-Agent

Integration mit Unterstützung deines KI-Agenten

Die Händler-API stellt einen MCP-Server bereit. Über seine URL kann dein Agent die Dokumentation lesen, nach deiner Zustimmung eine Anwendung erstellen, den Webhook einrichten und Integrationscode schreiben. Du musst den Token nicht manuell kopieren.

  1. Schritt 1

    Anweisung an den Agenten senden

  2. Schritt 2

    Anwendung in Telegram genehmigen

  3. Schritt 3

    Einrichtung durch den Agenten abschließen

Ablauf, Anweisungen für Clients und Token-Berechtigungen →
Anweisung für deinen KI-Agenten
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Funktionen

Zahlungen in dein Produkt integrieren

Erstelle Rechnungen per API-Anfrage und empfange Statusmeldungen per Webhook. Den weiteren Ablauf bestimmst du.

Token und Testumgebung

Nutze einen separaten Token im Testnet, um den Zahlungsablauf vor dem Einsatz mit echtem Guthaben zu prüfen.

Rechnungen per API

Erstelle, storniere und prüfe Rechnungen mit HTTP-Anfragen. Ein SDK ist nicht erforderlich.

Wiederkehrende Abbuchungen

Biete Abos an: Nach der Zustimmung des Nutzers erfolgen Abbuchungen über die Händler-API nach dem vereinbarten Zeitplan.

Zahlungs-Webhooks

Nach der Zahlung wird ein Ereignis gesendet. Bei Zustellfehlern wird die Übermittlung erneut versucht. Verarbeite wiederholte Ereignisse ohne doppelte Ausführung.

Dokumentation und Beispiele

Methoden, Fehlercodes und fertige Anfragebeispiele findest du in der Entwicklerdokumentation.

Weitere Informationen im Hilfecenter

8 Coins · 16 Asset-Netzwerk-Kombinationen · ein Guthaben

GRAM BTC ETH SOL BNB LTC DOGE TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL USDCERC-20 · BEP-20 · SOL

Für Kanäle und den Verkauf in Telegram

Wähle deinen Bereich und entdecke die passenden Funktionen.

Für Creator Für Verkäufer Für Entwickler
Earn

Automatische Erträge auf dein Guthaben

Lege einen Teil deines Guthabens in Earn an. Die Erträge werden automatisch berechnet und deiner Wallet gutgeschrieben. Du kannst jederzeit Guthaben hinzufügen oder auszahlen.

Jährlicher Ertragssatz Stündliche Berechnung
USDT 4% auf die ersten 500 USDT 1% auf den Betrag über 500
GRAM 6% auf die ersten 300 GRAM 3% auf den Betrag über 300
Tägliche Gutschrift in der Wallet um 00:30 UTC Keine Gebühr für Ein- oder Auszahlungen bei Earn
Guthaben zu Earn hinzufügen
Earn-Übersicht
Bestätigung einer Auszahlung
Adresse stimmt überein
Sicherheit

Prüfung vor dem Senden

Bei einer Auszahlung werden Kryptowährungen an eine externe Adresse gesendet. Diese Schutzfunktionen begleiten deine Bestätigung.

  • Vor der Bestätigung
  • Vollständige Adresse, Netzwerk und Memo Die Adresse wird vollständig angezeigt, statt auf „4f3a…9c2b“ verkürzt zu werden. So siehst du, wohin und über welches Netzwerk du sendest.
  • Gespeicherte Adressen Auf Wunsch kannst du Auszahlungen auf zuvor gespeicherte und freigegebene Adressen beschränken.
  • PIN oder Face ID Jede Auszahlung muss bestätigt werden. Grundlage ist deine PIN; eingerichtete Biometrie kann sie auf dem jeweiligen Gerät ersetzen.
  • Mit „Bestätigen“ fortfahren
  • Zusätzliche Schutzfunktionen
  • Sicherheitsverzögerung bei großen Beträgen Wenn du diese Funktion aktivierst, werden entsprechende Auszahlungen zeitversetzt gesendet. Bis zum Senden kannst du sie stornieren.
  • AML-Prüfung der Transaktion Die Transaktion wird vor dem Senden auf Risiken im Zusammenhang mit Geldwäsche geprüft.
  • Benachrichtigungen zu deinen Vorgängen Benachrichtigungen helfen dir, unbekannte Vorgänge zu erkennen. Kritische Sicherheitsmeldungen werden immer gesendet.

Informationen zur Sicherheit

Konditionen

Konditionen vor der Bestätigung einsehen

Der abzubuchende Betrag wird vor der Bestätigung angezeigt – einschließlich der anfallenden Gebühren.

Einzahlungen in die Wallet Gutschrift nach den erforderlichen Netzwerkbestätigungen
Ohne Gebühr
Überweisungen per Telegram-Benutzernamen Die Überweisung erfolgt innerhalb von TgPay, deshalb fällt keine Netzwerkgebühr an
Ohne Gebühr
In der Wallet tauschen Kurs, Gebühr und endgültiger Betrag auf der Tauschübersicht
Vor der Bestätigung sichtbar
An eine externe Wallet auszahlen Adresse, Netzwerk und gegebenenfalls Memo vor dem Senden prüfen
Auszahlungsgebühr laut App
Guthaben zu Earn hinzufügen oder daraus auszahlen Keine feste Bindungsfrist
Ohne Gebühr

Aktuelle Gebühren und Mindestbeträge findest du in der App. Die vollständige Übersicht steht im Hilfecenter.

USDT GRAM BTC ETH SOL BNB LTC DOGE
8 Coins · 16 Asset-Netzwerk-Kombinationen – ein Guthaben

Du brauchst keine separate Wallet für jedes Netzwerk. Wähle bei Ein- und Auszahlungen das passende unterstützte Netzwerk.

TRC-20 · ERC-20 · BEP-20 · TON · SOL · BTC · LTC · DOGE

online Support in Telegram
Meine TRC-20-Auszahlung ist noch nicht angekommen. Bitte prüft den Status. Wir prüfen die Transaktion und antworten dir hier im Chat.
@tgpayhelpbot
Häufige Fragen

Häufige Fragen

Informationen zur Wallet, zu Überweisungen, Earn und zum Empfang von Zahlungen.

Deine Wallet wird beim ersten Öffnen von @tgpaycryptobot erstellt. Du brauchst weder einen zusätzlichen Login noch ein Passwort oder eine Seed-Phrase. Der Zugang ist mit deinem Telegram-Konto verknüpft.

Unterstützt werden GRAM, BTC, ETH, SOL, BNB, LTC, DOGE und TRX sowie USDT in fünf und USDC in drei Netzwerken. Insgesamt sind das 16 Asset-Netzwerk-Kombinationen. Bei Ein- und Auszahlungen wählst du das Netzwerk und verwendest die dafür angezeigte Adresse.

Gib den Benutzernamen des Empfängers ein. Du brauchst keine Adresse; die Überweisung bleibt innerhalb von TgPay und verursacht keine Netzwerkgebühr. Alternativ kannst du einen Scheck senden, den der Empfänger selbst einlöst.

Du legst einen Teil deines Guthabens in Earn an. Auf die ersten 500 USDT erhältst du 4 % jährlich, auf den darüberliegenden Betrag 1 %. Bei GRAM gelten 6 % jährlich für die ersten 300 GRAM und 3 % für den darüberliegenden Betrag. Die Erträge werden stündlich berechnet und deiner Wallet täglich um 00:30 UTC gutgeschrieben. Guthaben kannst du jederzeit ohne Gebühr hinzufügen oder auszahlen.

Mit einem Scheck versendest du Kryptowährungen per Link oder QR-Code. Er kann für einen Empfänger oder mehrere Einlösungen bestimmt, mit einem Passwort und Ablaufdatum versehen oder auf Kanalabonnenten beziehungsweise Telegram-Premium-Nutzer beschränkt werden. Du kannst den Scheck pausieren, Betrag und Anzahl der Einlösungen bearbeiten oder ihn löschen. Nicht eingelöstes Guthaben wird dir zurückgebucht.

Für Überweisungen per Benutzernamen fällt keine Netzwerkgebühr an. Bei Auszahlungen wird die in der App angezeigte Auszahlungsgebühr berechnet. Tauschgebühr und endgültiger Betrag werden vor der Bestätigung angezeigt. Aktuelle Gebühren und Mindestbeträge findest du in der App und im Hilfecenter.

Erstelle Rechnungen direkt in der App. Mit der Händler-API kannst du den Ablauf automatisieren: Eine API-Anfrage erstellt die Rechnung, ein Webhook meldet den Zahlungseingang. Die Methoden sind in der Entwicklerdokumentation beschrieben.

Weitere Antworten findest du im Hilfecenter Bei weiteren Fragen hilft dir @tgpayhelpbot

Deine Wallet in wenigen Schritten öffnen

Öffne @tgpaycryptobot in Telegram. Deine Wallet wird erstellt und kann Kryptowährungen empfangen.

In Telegram öffnen
Bereich:
Privat Für Creator Für Verkäufer Für Entwickler