Um die EBANX-Zahlungsplattform in Mavibot zu nutzen, müssen Sie Ihren Integration Key aus Ihrem EBANX-Konto abrufen und in den Zahlungseinstellungen eingeben.

EBANX ist ein Aggregator lokaler Zahlungsmethoden in ganz Lateinamerika. Zahlungen werden auf einer sicheren, von EBANX gehosteten Checkout-Seite abgewickelt, auf der dem Kunden die in seinem Land verfügbaren Zahlungsmethoden angezeigt werden (z. B. PIX und Boleto in Brasilien, OXXO und SPEI in Mexiko, PSE in Kolumbien, Kredit-/Debitkarten und mehr).

Abrufen des Integration Key

Schließen Sie eine Vereinbarung mit EBANX ab und erhalten Sie Zugang zum EBANX Business Portal (Ihr Händler-Dashboard).

Wählen Sie während des Onboarding-Prozesses die Länder aus, in denen Sie Zahlungen akzeptieren möchten. Kunden können nur aus den Ländern bezahlen, die in Ihrem EBANX-Konto aktiviert sind.

Kopieren Sie in den Integrationseinstellungen Ihren Integration Key. Sie benötigen ihn, um EBANX mit Mavibot zu verbinden.

Zu Testzwecken stellt EBANX ein separates Sandbox-Konto mit einem eigenen Integration Key zur Verfügung. Siehe Testmodus unten.

Verbinden von EBANX

Wählen Sie in den Zahlungssystemeinstellungen EBANX aus und geben Sie Folgendes ein:

  • Integration Key — Ihr kopierter EBANX Integration Key.
  • Land — das Standard-Zahlungsland (zweistelliger Kleinbuchstaben-Ländercode: br für Brasilien, mx für Mexiko, co für Kolumbien, cl für Chile, pe für Peru, ar für Argentinien usw.). Dies bestimmt, welche Zahlungsmethoden der Kunde auf der Checkout-Seite sieht. Das ausgewählte Land muss in Ihrem EBANX-Konto aktiviert sein.
  • Testmodus — aktivieren Sie diese Option, um die Integration mit der EBANX-Sandbox-Umgebung zu testen. Wenn der Testmodus aktiviert ist, verwenden Sie den Integration Key aus Ihrem Sandbox-Konto. Um echte Zahlungen zu akzeptieren, deaktivieren Sie den Testmodus und verwenden Sie Ihren Live-Integration Key.

Die Einrichtung ist nun abgeschlossen.

Rechnerfunktion:

get_ebanx_payment_url(betrag, beschreibung, währung, kunden_email, vollständiger_name, land)

Parameter

  • betrag — Zahlungsbetrag. Erforderlich.

  • kunden_email — E-Mail-Adresse des Kunden. Erforderlich. EBANX kann ohne diese keine Zahlung erstellen. Der Kunde erhält außerdem eine Zahlungsbestätigung an diese E-Mail-Adresse.

  • vollständiger_name — vollständiger Name des Kunden. Erforderlich.

  • beschreibung — Zahlungsbeschreibung. Optional.

  • währung — Zahlungswährung. Sie können entweder:

    • die lokale Währung des Zahlungslandes (z. B. BRL, MXN, COP, CLP, PEN, ARS usw.) oder
    • Ihre EBANX-Kontowährung (normalerweise USD) verwenden, in diesem Fall rechnet EBANX den Betrag zu seinem Wechselkurs um.

    Optional. Der Standardwert ist USD.

  • land — Zahlungsland (zweistelliger Kleinbuchstaben-Ländercode). Optional. Wenn nicht angegeben, wird das in den Zahlungseinstellungen festgelegte Standardland verwendet.

Die Funktion gibt eine Zahlungs-URL zurück.

Hinweis: Die ausgewählte Währung muss mit dem Zahlungsland kompatibel sein. Es muss entweder die lokale Währung des Landes oder Ihre EBANX-Kontowährung sein. Für br (Brasilien) sind beispielsweise BRL und USD gültig, MXN jedoch nicht.

Um einen Zahlungsbutton zu senden, wählen Sie den Typ Zahlungsbutton und EBANX als Zahlungssystem aus.

Geben Sie ein:

  • Produktname;
  • Zahlungsbetrag;
  • Währung;
  • Variablen mit dem vollständigen Namen und der E-Mail-Adresse des Kunden.

Optional können Sie das Zahlungsland angeben.

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:

betrag = 1000
beschreibung = "Produkt1 ist ein Produkt von großer Zuverlässigkeit!"
währung = "BRL"
link = get_ebanx_payment_url(betrag, beschreibung, währung, kunden_email, vollständiger_name, land)

Wenn Sie Zahlungen in einer anderen Währung als USD akzeptieren möchten, geben Sie die Währung wie unten gezeigt an.

Beispiel 2. Abrechnungsbutton

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.

Geben Sie im sich öffnenden Fenster Folgendes ein:

  • Den Button-Text.
  • Wählen Sie die Funktion Abrechnung.
  • Wählen Sie EBANX als Zahlungsanbieter.

Geben Sie dann Folgendes ein:

  • Produktname.
  • Zahlungsbetrag.
  • Währung (optional).
  • Vollständiger Name des Kunden (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 Zahlung

Nachdem der Kunde den Zahlungslink geöffnet und die Zahlung abgeschlossen hat, wird bei erfolgreicher Zahlung der folgende Callback an die Konversation gesendet:

SDJ91MTKTT_success 100

Wobei:

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

Wenn die Zahlung storniert wird, wird der folgende Callback gesendet:

SDJ91MTKTT_fail 100

Bei Offline-Zahlungsmethoden (wie Boleto, OXXO usw.) erfolgt die Zahlungsbestätigung nicht sofort. EBANX sendet den Callback erst nach Erhalt der Gelder, was 1–3 Werktage dauern kann. Der Callback wird automatisch zugestellt, sobald die Zahlung bestätigt wurde.

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 sein.

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 sein.

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 weiter aufbauen.

Kunden-Variablen nach einer erfolgreichen Zahlung

Variable Wert
ebanx_callback_data Zahlungsinformationen, die vom Zahlungssystem empfangen wurden
ebanx_payment_completed "True" — Zahlung wurde als erfolgreich verarbeitet
ebanx_payment_hash Zahlungs-ID bei EBANX (Hash)