Verbinden von PayTabs mit Mavibot
Um PayTabs mit Mavibot zu verbinden, müssen Sie mehrere Einstellungen in Ihrem PayTabs-Konto konfigurieren.
1. Erstellen eines API-Schlüssels
Gehen Sie in Ihrem PayTabs-Dashboard zu:
Entwickler → API-Schlüssel
Erstellen Sie einen neuen API-Schlüssel.
Nach der Erstellung des API-Schlüssels speichern Sie die folgenden Details:
- Server-Schlüssel – erforderlich für die Einrichtung der Integration.
- Profil-ID – ebenfalls erforderlich für die Verbindungseinrichtung.
2. Konfigurieren von Zahlungsbenachrichtigungen
Gehen Sie zu:
Entwickler → Konfiguration
Aktivieren Sie Zahlungsbenachrichtigungen (Callbacks).
Klicken Sie auf „+" und fügen Sie die folgende Callback-URL hinzu:
https://chatter.mavibot.ai/paytabs_callback/result
Diese URL wird verwendet, um Zahlungsstatusaktualisierungen an Mavibot zu senden.
3. Konfigurieren von PayTabs in Mavibot
Gehen Sie in den Mavibot-Einstellungen:
- Zum Abschnitt Acquiring
- Wählen Sie PayTabs als Zahlungsanbieter
- Geben Sie die folgenden Details ein:
- Profil-ID
- Server-Schlüssel
- Wählen Sie Ihre PayTabs-Kontoregion
Bitte beachten Sie!
Die ausgewählte Region muss mit der Region übereinstimmen, in der Ihr PayTabs-Konto registriert ist.
Sobald die Einstellungen gespeichert sind, ist die Integrationseinrichtung abgeschlossen.
Erstellen eines Zahlungslinks
Um einen Zahlungslink zu erstellen, verwenden Sie die folgende Funktion:
get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)
Funktionsparameter
| Parameter | Beschreibung |
|---|---|
| ! amount | Zahlungsbetrag. Erforderlicher Parameter |
| description | Zahlungsbeschreibung. Optionaler Parameter |
| currency | Zahlungswährung. Optionaler Parameter |
| customer_email | E-Mail-Adresse des Kunden. Optionaler Parameter |
| customer_phone | Telefonnummer des Kunden. Optionaler Parameter |
| full_name | Vollständiger Name des Kunden. Optionaler Parameter |
| language | Sprache der Zahlungsseite. Optionaler Parameter |
Verfügbare Währungen
Die folgenden Währungscodes werden unterstützt:
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
Verfügbare Sprachen
en — Englisch
ar — Arabisch
fr — Französisch
Die Funktion gibt eine Zahlungs-URL zurück.
Wenn der Parameter currency nicht angegeben wird, wird die Währung automatisch basierend auf der konfigurierten Region ausgewählt.
Verwenden des Zahlungslinks in einer Schaltfläche
Um einem Kunden eine Zahlungsschaltfläche zu senden:
- Erstellen Sie eine Schaltfläche vom Typ Zahlung
- Wählen Sie PayTabs als Zahlungsanbieter
- Geben Sie an:
- Zahlungsbeschreibung;
- Zahlungsbetrag;
- Währung.
Behandlung des Zahlungsstatus
Nachdem der Kunde den Zahlungslink geöffnet und die Zahlung abgeschlossen hat, wird ein Callback-Ereignis an die Konversation gesendet.
Erfolgreiche Zahlung
Beispiel:
SDJ91MTKTT_success 100
Wobei:
- SDJ91MTKTT — die ersten 10 Zeichen des Server-Schlüssels
- 100 — der Zahlungsbetrag
Um eine Aktion für eine erfolgreiche Zahlung zu erstellen, gehen Sie zu Builder und erstellen Sie einen Block mit einem Auslöser (dies kann ein Start-Block oder ein Trigger-Block sein).
Geben Sie dann im Feld Trigger ein:
- den vollständigen Callback-Wert (wenn Sie die Aktion nur für einen bestimmten Zahlungsbetrag auslösen möchten), oder
- nur den Callback-Wert vor dem Zahlungsbetrag (wenn Sie die Aktion für alle erfolgreichen Zahlungen auslösen möchten).
Fehlgeschlagene Zahlung
Beispiel:
SDJ91MTKTT_fail 100
Die Behandlung fehlgeschlagener Zahlungen wird auf die gleiche Weise wie die Behandlung erfolgreicher Zahlungen konfiguriert.
Erstellen Sie einen Block mit einem Auslöser und geben Sie den Callback-Wert im Feld Trigger ein. Dadurch können Sie Aktionen definieren, die ausgeführt werden, wenn eine Zahlung fehlschlägt.
Nach einer erfolgreichen Zahlung gespeicherte Variablen
Nach einer erfolgreichen Zahlung werden die folgenden Variablen automatisch für den Kunden gespeichert:
paytabs_callback_data
Enthält die vollständige Webhook-Nutzlast, die vom Zahlungssystem empfangen wurde.
paytabs_payment_completed
Wert:
True
Zeigt an, dass die Zahlung erfolgreich abgeschlossen wurde.