Die PayTR-Integration ermöglicht es Ihnen, Zahlungen über PayTR, einen türkischen Zahlungsdienstleister, zu akzeptieren. Kunden schließen ihre Zahlungen auf der sicheren PayTR-Zahlungsseite ab, wo sie türkische Bankkarten und andere lokale Zahlungsmethoden nutzen können.

Integrationsdaten abrufen

Bevor Sie PayTR verbinden, schließen Sie einen Vertrag mit PayTR ab und erhalten Sie Zugang zu Ihrem Händlerkonto.

Öffnen Sie im linken Menü Bilgi (Informationen) und suchen Sie den Abschnitt API Entegrasyon Bilgileri. Kopieren Sie die folgenden Werte:

PayTR-Dashboard Mavibot-Feld
Mağaza No Händler-ID (merchant_id)
Mağaza Anahtarı Händlerschlüssel (merchant_key)
Mağaza Şifresi Händler-Salt (merchant_salt)

Hinweis: Diese Anmeldedaten sind nur für den Ana Kullanıcı (Hauptbenutzer) und den Teknik Sorumlu (Technisch Verantwortlichen) verfügbar. Wenn Sie diesen Abschnitt nicht sehen können, bitten Sie den Hauptkontoinhaber, Ihnen die erforderlichen Berechtigungen zu erteilen.

Sie müssen keine Zahlungsbenachrichtigungs-URL (Callback) im PayTR-Dashboard konfigurieren. Mavibot sendet die Callback-URL automatisch mit jeder Zahlungslink-Anfrage.

PayTR verbinden

Öffnen Sie die Acquiring-Einstellungen in Mavibot und wählen Sie PayTR.

Geben Sie die folgenden Anmeldedaten ein:

  • Händler-ID (merchant_id) — Ihre Mağaza No
  • Händlerschlüssel (merchant_key) — Ihr Mağaza Anahtarı
  • Händler-Salt (merchant_salt) — Ihr Mağaza Şifresi

Speichern Sie die Einstellungen, um die Integration abzuschließen.

Verwenden Sie die Rechnerfunktion:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Parameter

Parameter Erforderlich Beschreibung
amount ✅ Zahlungsbetrag.
description Nein Zahlungsbeschreibung (Produkt oder Dienstleistung). Wird auf der PayTR-Zahlungsseite angezeigt.
currency Nein Zahlungswährung: TL, USD, EUR, GBP oder RUB. Standard: TL.
customer_email Nein E-Mail-Adresse des Kunden.
product_name Nein Produktname, der auf der Zahlungsseite angezeigt wird.
expired Nein Lebensdauer des Zahlungslinks in Sekunden. Wenn nicht angegeben, läuft der Link nie ab.
language Nein Sprache der Zahlungsseite: tr (Türkisch) oder en (Englisch). Standard: tr.

Die Funktion gibt eine Zahlungs-URL zurück.

Hinweise

  • Der Währungscode TRY wird automatisch in TL umgewandelt.
  • Wenn eine nicht unterstützte Währung angegeben wird, wird automatisch TL verwendet.
  • Der Produktname muss 4–200 Zeichen enthalten.
    • Namen mit weniger als 4 Zeichen werden mit Punkten (.) aufgefüllt.
    • Namen mit mehr als 200 Zeichen werden automatisch gekürzt.

Beispiel

Schritt 1

Erstellen Sie eine Nachricht, die den Kunden auffordert, seine E-Mail-Adresse einzugeben.

Schritt 2

Erstellen Sie den nächsten Block unterhalb der Nachricht und öffnen Sie die Pfeil-Einstellungen.

Konfigurieren Sie die Verbindung wie folgt:

  • Abgleichstyp: Regulärer Ausdruck
  • Aktivieren Sie die Option Benutzer gibt Daten ein.
  • Geben Sie den Variablennamen ein: customer_email

Speichern Sie die Verbindungseinstellungen.

Schritt 3

Geben Sie die Funktionsparameter im Rechner ein.

Einen Zahlungsbutton erstellen

Um einen Zahlungsbutton in Mavibot zu senden:

  1. Erstellen Sie den Block mit einem Button.

  1. Wählen Sie den Typ Abrechnung.
  2. Wählen Sie PayTR als Zahlungsanbieter.
  3. Geben Sie an:
    • Produktname
    • Zahlungsbetrag
    • Währung
  4. Geben Sie optional die Variable mit der E-Mail-Adresse des Kunden an.

Zahlungs-Callbacks

Nachdem der Kunde die Zahlung abgeschlossen hat, empfängt Mavibot einen Callback und veröffentlicht ihn im Gespräch.

Erfolgreiche Zahlung

SDJ91MTKTT_success 100

Wobei:

  • SDJ91MTKTT die ersten 10 Zeichen Ihres Händlerschlüssels (merchant_key) sind.
  • 100 der Zahlungsbetrag ist.

Um auf erfolgreiche oder fehlgeschlagene Zahlungen zu reagieren, kopieren Sie den Callback-Wert und erstellen Sie einen Start-Block (oder Trigger-Block).

Geben Sie den Callback-Text im Trigger ein.

Erstellen Sie dann eine Nachricht, die den Kunden darüber informiert, ob die Zahlung erfolgreich war oder fehlgeschlagen ist.

Von diesem Block aus können Sie Ihren Chatbot-Fluss nach Bedarf fortsetzen.

Hinweis: Die in diesem Beispiel gezeigte Trigger-Konfiguration reagiert auf jede erfolgreiche Zahlung, da sie nur das Callback-Präfix ohne den Zahlungsbetrag verwendet.
Wenn Sie nur auf den Kauf eines bestimmten Produkts oder Zahlungsbetrags reagieren möchten, geben Sie den vollständigen Callback-Text einschließlich des Zahlungsbetrags ein und ändern Sie den Abgleichstyp auf Exakte Übereinstimmung.

Fehlgeschlagene Zahlung

SDJ91MTKTT_fail 100

Hinweis: PayTR-Zahlungslinks sind Einmal-Links. Nach einer erfolgreichen Zahlung wird der Link automatisch deaktiviert. Generieren Sie für jede neue Zahlung einen neuen Zahlungslink.

Kundenvariablen nach einer erfolgreichen Zahlung

Variable Beschreibung
paytr_callback_data Von PayTR erhaltene Zahlungsinformationen.
paytr_payment_completed "True", wenn die Zahlung erfolgreich verarbeitet wurde.
paytr_merchant_oid PayTR-Transaktionskennung (merchant_oid).