Telr verbinden

Um das Telr-Zahlungssystem in MaviBot zu nutzen, müssen Sie Ihre Shop-Anmeldedaten aus Ihrem Telr-Konto abrufen und in den Zahlungssystemeinstellungen eingeben.

Shop-Anmeldedaten abrufen

Schließen Sie eine Vereinbarung mit Telr ab und erhalten Sie Zugang zu Ihrem Händlerkonto.

Kopieren Sie in Stores → Store details die folgenden Werte:

Telr-Feld MaviBot-Feld
Store ID Store ID
Authentication key Authentifizierungsschlüssel

Zahlungsbenachrichtigungen konfigurieren

Öffnen Sie Payment Page (oder Security) → Transaction advice und geben Sie die folgende Benachrichtigungs-URL an:

https://chatter.mavibot.ai/telr_callback/result

Wählen Sie die Transaktionsarten aus, für die Sie Benachrichtigungen erhalten möchten.

Kopieren Sie im selben Abschnitt den Secret key. Dieser Schlüssel wird verwendet, um die Signaturen der Benachrichtigungen zu überprüfen.

Wichtig! Die Konfiguration von Transaction advice ist zwingend erforderlich. Ohne sie erhält MaviBot keine Zahlungsbenachrichtigungen und es wird kein Callback an den Bot gesendet.

Telr in MaviBot verbinden

Öffnen Sie Zahlungssysteme in Ihren Projekteinstellungen, wählen Sie Telr aus und füllen Sie die folgenden Felder aus:

Feld Beschreibung
Store ID Numerische Kennung Ihres Telr-Shops.
Authentication Key Wird verwendet, um Zahlungslinks zu generieren.
Secret Key Wird verwendet, um die Signaturen von Zahlungsbenachrichtigungen zu überprüfen. Ohne diesen Schlüssel werden Zahlungsbenachrichtigungen abgelehnt.
Testmodus Aktiviert Testzahlungen mit Telr-Testkarten, ohne dass echtes Geld abgebucht wird. Deaktivieren Sie diese Option, um echte Zahlungen zu akzeptieren.

Sobald alle Felder ausgefüllt sind, ist die Integration einsatzbereit.

Generieren eines Zahlungslinks

Verwenden Sie die folgende Calculator-Funktion:

get_telr_payment_url(amount, description, currency, product_name)

Parameter

Parameter Beschreibung
amount Zahlungsbetrag. Erforderlich.
description Zahlungsbeschreibung. Optional. Maximale Länge: 63 Zeichen.
currency Dreibuchstabiger Währungscode (AED, SAR, USD, EUR, GBP und andere für Ihr Telr-Konto verfügbare Währungen). Optional. Standard: AED.
product_name Produktname. Optional.

Die Funktion gibt eine Zahlungs-URL zurück.

Wichtig! Zahlungslinks sind nur für eine begrenzte Zeit gültig. Senden Sie den Link sofort nach der Generierung an den Kunden.

Beispiel

Um einen Zahlungsbutton zu senden:

  1. Erstellen Sie einen Button mit der Funktion Bezahlen.
  2. Wählen Sie Telr als Zahlungssystem aus.
  3. Geben Sie an:
    • Produktname
    • Zahlungsbetrag
    • Währung

Zahlungs-Callbacks

Nachdem der Kunde die Zahlung abgeschlossen hat, empfängt MaviBot automatisch einen Callback.

Erfolgreiche Zahlung

Beispiel:

SDJ91MTKTT_success 100

Wobei:

  • SDJ91MTKTT — die ersten 10 Zeichen Ihres Authentifizierungsschlüssels.
  • 100 — der Zahlungsbetrag.

Fehlgeschlagene oder stornierte Zahlung

Beispiel:

SDJ91MTKTT_fail 100

Zahlung in Bankprüfung

Wenn eine Zahlung autorisiert, aber von der Bank zur zusätzlichen Überprüfung zurückgehalten wird, wird kein Callback gesendet, bis die Prüfung abgeschlossen ist.

Sobald die Bank die Transaktion genehmigt oder ablehnt, sendet Telr eine Benachrichtigung und der Callback wird automatisch an MaviBot übermittelt.

Kunden-Variablen nach einer erfolgreichen Zahlung

Variable Beschreibung
telr_callback_data Zahlungsinformationen, die vom Telr-Zahlungssystem empfangen wurden.
telr_payment_completed "True", wenn die Zahlung erfolgreich verarbeitet wurde.
telr_tran_ref Telr-Transaktionsreferenz (tran_ref).