Um den Clip in MaviBot zu verwenden, müssen Sie in Ihrem Clip-Konto ein Paar Anmeldeinformationen erstellen und diese in den Zahlungssystemeinstellungen eingeben.

Clip ist ein mexikanischer Zahlungsdienst.

Anmeldeinformationen abrufen

Schließen Sie eine Vereinbarung mit Clip ab und erhalten Sie Zugriff auf das Entwickler-Dashboard in Ihrem Clip-Konto.

Klicken Sie im Bereich Anmeldeinformationen auf Crear credencial (Anmeldeinformationen erstellen), geben Sie einen Namen ein und bestätigen Sie die Erstellung.

Kopieren Sie die folgenden Anmeldeinformationen:

  • API-Schlüssel
  • Clave secreta (Geheimer Schlüssel)

Wichtig! Der geheime Schlüssel wird nur einmal angezeigt, unmittelbar nachdem die Anmeldeinformationen erstellt wurden. Speichern Sie ihn an einem sicheren Ort. Sie können ihn in Ihrem Clip-Konto nicht erneut anzeigen. Wenn Sie ihn verlieren, müssen Sie ein neues Paar Anmeldeinformationen erstellen.

Anmeldeinformationen werden getrennt für Produktions- und Testumgebungen erstellt. Sie können bis zu 6 Anwendungen pro Konto erstellen.

Erstellen Sie für Integrationstests ein Testpaar von Anmeldeinformationen. Um echte Zahlungen zu akzeptieren, verwenden Sie Produktionsanmeldeinformationen.

Sie müssen keine Zahlungsbenachrichtigungs-URL in Ihrem Clip-Konto konfigurieren. MaviBot sendet die Benachrichtigungs-URL automatisch, wenn jede Zahlung erstellt wird.

Clip verbinden

Wählen Sie im Tab Acquiring die Option Clip und geben Sie Folgendes ein:

Feld Beschreibung
API-Schlüssel Anwendungsidentifikator.
Geheimer Schlüssel (Clave secreta) Geheimer Anwendungsschlüssel.

Die Verbindung ist nun abgeschlossen.

Verwenden Sie die folgende Calculator-Funktion:

get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)

Parameter

Parameter Beschreibung
amount Zahlungsbetrag. Erforderlich. Der Mindestbetrag ist 1 in der Hauptwährungseinheit. Geben Sie den Betrag als 100.55 an, nicht als 10055.
description Zahlungsbeschreibung. Optional. Maximale Länge: 250 Zeichen. Der Kunde kann sie auf der Zahlungsseite und der Quittung sehen.
currency Dreibuchstabiger Währungscode (MXN und andere für Ihr Clip-Konto verfügbare Währungen). Optional. Standard: MXN.
customer_email E-Mail-Adresse des Kunden. Optional. Wird automatisch in das Zahlungsformular eingefügt.
customer_phone Telefonnummer des Kunden. Optional. Wird automatisch in das Zahlungsformular eingefügt.
full_name Name des Kunden. Optional. Wird automatisch in das Zahlungsformular eingefügt.
product_name Produktname. Optional.
language Sprache der Zahlungsseite: es für Spanisch (Standard) oder en für Englisch.

Die Funktion gibt eine Zahlungs-URL zurück.

Um dem Kunden einen Zahlungsbutton zu senden:

  1. Erstellen Sie einen Button mit der Funktion Bezahlen.
  2. Wählen Sie Clip als Zahlungssystem.
  3. Geben Sie den Produktnamen, den Betrag und die Währung an.
  4. Geben Sie bei Bedarf Variablen mit dem Namen, der E-Mail-Adresse und der Telefonnummer des Kunden an.

Zahlungs-Callbacks

Nachdem der Kunde dem Zahlungslink gefolgt ist und die Zahlung abgeschlossen hat, empfängt MaviBot einen Callback.

Erfolgreiche Zahlung

Beispiel:

SDJ91MTKTT_success 100.55

Wobei:

  • SDJ91MTKTT — die ersten 10 Zeichen Ihres API-Schlüssels.
  • 100.55 — der Zahlungsbetrag.

Fehlgeschlagene Zahlung

Wenn die Zahlung nicht erfolgreich ist, wird der folgende Callback gesendet:

SDJ91MTKTT_fail 100.55

Wichtig! Ein Callback für eine fehlgeschlagene Zahlung wird nur gesendet, nachdem der Zahlungslink endgültig geschlossen wurde: nach 5 fehlgeschlagenen Zahlungsversuchen oder wenn der Link abläuft.

Solange der Kunde noch Zahlungsversuche zur Verfügung hat, bleibt der Link aktiv und es wird kein Callback für eine fehlgeschlagene Zahlung gesendet.

Kunden-Variablen nach einer erfolgreichen Zahlung

Variable Beschreibung
clip_callback_data Zahlungsinformationen, die vom Clip-Zahlungssystem empfangen wurden.
clip_payment_completed "True", wenn die Zahlung erfolgreich verarbeitet wurde.
clip_payment_request_id Zahlungslink-Identifikator in Clip.
clip_receipt_no Clip-Quittungsnummer.