Um das Garanti BBVA (Sanal POS) Zahlungssystem in Mavibot zu nutzen, müssen Sie die Zugangsdaten für das virtuelle POS-Terminal von der Bank erhalten und in den Integrationseinstellungen eingeben. Die Zahlung wird auf der sicheren Seite der Bank mit 3D Secure Bestätigung abgewickelt.

Zugangsdaten erhalten

Schließen Sie einen Vertrag mit Garanti BBVA für den Sanal POS (virtuelles POS) Service ab. Bitten Sie die Bank bei der Aktivierung des Dienstes, Ortak Ödeme (gemeinsame Zahlungsseite) für Ihr Terminal zu aktivieren. Ohne diese Funktion funktionieren Zahlungen über die Zahlungsseite der Bank nicht.

Die Bank stellt Ihnen Folgendes zur Verfügung:

  • Merchant ID (Üye İşyeri No) — Ihre Händler-ID;
  • Terminal ID — Ihre Terminal-ID;
  • Provision User ID — der Bereitstellungs-Benutzername (normalerweise PROVAUT oder PROVOOS);
  • Provision Password — das Bereitstellungs-Benutzerpasswort.

Der Store Key (3D Secure-Schlüssel) wird von Ihnen im Sanal POS Verwaltungspanel (Yönetim → 3D Secure) erstellt. Speichern Sie ihn unbedingt, da er auch für die Integration erforderlich ist.

Wie verbinde ich Garanti BBVA mit Mavibot?

Wählen Sie im Bereich Acquiring von Mavibot die Option Garanti BBVA und geben Sie die folgenden Details ein:

  • Merchant ID — Ihre Händler-ID.
  • Terminal ID — Ihre Terminal-ID.
  • Provision User ID — der Bereitstellungs-Benutzername. Wenn leer gelassen, wird PROVAUT verwendet.
  • Provision Password — das Bereitstellungs-Benutzerpasswort.
  • Store Key — Ihr 3D Secure-Schlüssel.
  • Store Name — der Name, der Kunden auf der Zahlungsseite der Bank angezeigt wird. Wenn leer gelassen, wird "Online-Shop" angezeigt.
  • Test Mode — aktivieren Sie diese Option, um die Integration mit den Testzugangsdaten der Bank zu testen. Für die Verarbeitung von Live-Zahlungen muss diese Option deaktiviert sein.

Die Integration ist nun abgeschlossen.

Rechnerfunktion:

get_garanti_payment_url(amount, description, currency, customer_email, language)

Parameter:

Parameter Beschreibung Erforderlich Standard / Erlaubte Werte
amount Zahlungsbetrag. ✅ —
description Zahlungsbeschreibung. Nein —
currency Zahlungswährung. Nein TRY (Standard). Unterstützte Werte: TRY, USD, EUR, GBP, JPY
customer_email E-Mail-Adresse des Kunden. Nein —
language Sprache der Zahlungsseite. Nein tr (Standard). Unterstützte Werte: tr, en

Die Funktion gibt eine Zahlungs-URL zurück.

Um einen Button mit einem Zahlungslink zu senden, wählen Sie den Button-Typ Zahlung und wählen Sie Garanti BBVA als Zahlungsanbieter. Geben Sie dann den Produktnamen, den Zahlungsbetrag und gegebenenfalls die Zahlungswährung ein.

Beispiel 1: Workflow-Konfiguration

Schritt 1. Erstellen Sie einen Start-Block.

Der Start-Block wird normalerweise verwendet, um die erste Begrüßungsnachricht im Workflow zusammen mit allen erforderlichen Einführungsinformationen anzuzeigen.

Schritt 2. Erstellen Sie den unten gezeigten Block.

Schritt 3. Gehen Sie zu den Verbindungs-Einstellungen.

Sie benötigen den folgenden regulären Ausdruck, um zu überprüfen, ob der Kunde eine gültige E-Mail-Adresse eingegeben hat:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Aktivieren Sie außerdem die Option Benutzer gibt Daten ein und geben Sie customer_email ein.

Schritt 4. Geben Sie die Nachricht im zweiten Block ein.

Schritt 5. Erstellen Sie einen dritten Block und öffnen Sie die Verbindungs-Einstellungen zwischen dem zweiten und dritten Block.

Aktivieren Sie den Timer, um automatisch zum nächsten Block zu gelangen.

Schritt 6. Geben Sie im dritten Block die Funktion im Rechner ein.

Beispiel zum Kopieren:

amount = 1000
description = "Product1 ist ein Produkt von großer Zuverlässigkeit!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

Wenn Sie Zahlungen in einer anderen Währung als Türkische Lira (TRY) akzeptieren möchten, geben Sie die Währung wie unten gezeigt an.

Beispiel zum Kopieren:

amount = 1000
description = "Product1 ist ein Produkt von großer Zuverlässigkeit!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

Beispiel 2. Rechnungs-Button

Dieses Beispiel ist fast identisch mit Beispiel 1.

Anstatt jedoch einen dritten Block mit einer Funktion zum Generieren des Zahlungslinks zu erstellen, können Sie im zweiten Block einen Button erstellen.

Im sich öffnenden Fenster:

  • Geben Sie den Button-Text ein.
  • Wählen Sie die Funktion Abrechnung.
  • Wählen Sie Garanti BBVA als Zahlungsanbieter.

Geben Sie dann Folgendes ein:

  • Produktname.
  • Zahlungsbetrag.
  • Währung (optional).
  • Vollständiger Kundenname (optional). Sie können dies genauso konfigurieren wie die Eingabe der Kunden-E-Mail.
  • Kunden-E-Mail — geben Sie die Variable #{customer_email} ein.

Klicken Sie dann auf Hinzufügen.

Benachrichtigungen nach der Zahlung

Nachdem der Kunde dem Zahlungslink gefolgt ist und die Zahlung abgeschlossen hat, wird eine Benachrichtigung (Callback) an die Konversation gesendet.

Bei erfolgreicher Zahlung:

SDJ91MTKTT_success 100

Wo:

  • SDJ91MTKTT sind die ersten 10 Zeichen Ihres Store Key.
  • 100 ist der Zahlungsbetrag.

Wenn die Zahlung fehlschlägt, wird die folgende Benachrichtigung gesendet:

SDJ91MTKTT_fail 100

So senden Sie eine Antwort auf eine erfolgreiche oder fehlgeschlagene Zahlung

Schritt 1. Erstellen Sie einen Trigger-Block.

Schritt 2. Geben Sie im Bedingungsfeld den Benachrichtigungstext SDJ91MTKTT_success — ohne den Zahlungsbetrag — ein, wenn Sie auf jede Zahlung reagieren möchten.

In diesem Fall sollte der Match-Typ auf Nach Schlüsselwörtern gesetzt werden.

Alternativ geben Sie den gesamten Callback-Text in das Trigger-Feld ein, wenn Sie auf eine bestimmte Zahlung reagieren möchten. In diesem Fall muss der Match-Typ auf Exakte Übereinstimmung gesetzt werden.

Wenn Sie den Workflow nach einer erfolgreichen Zahlung fortsetzen möchten, können Sie anstelle eines Trigger-Blocks einen Start-Block erstellen und den Bot-Flow von dort aus fortsetzen.

Kundenvariablen nach einer erfolgreichen Zahlung