Ein Button mit der Zahlungsfunktion vereinfacht die Arbeit mit angebundenen Zahlungssystemen, indem er einen Zahlungslink bereitstellt.

Bild

Bitte beachten Sie, dass in vielen Messengern Links nur in Inline-Buttons innerhalb des Textes platziert werden können. Vergessen Sie nicht, nach der Erstellung des Buttons den entsprechenden Button-Typ in den Blockeinstellungen auszuwählen.

Der Button mit der Zahlungsfunktion ist für folgende Zahlungssysteme verfügbar:

  • Stripe

Innerhalb eines einzelnen Blocks können Sie „Zahlungs“-Buttons für verschiedene Zahlungssysteme mit unterschiedlichen Zahlungsbeträgen erstellen.

Wenn keine Zahlungssysteme mit dem Projekt verbunden sind, ist dieser Button-Typ nicht verfügbar.

Bild

Hauptfelder des Zahlungs-Buttons:

  • Textfeld: Dieser Text wird auf dem Button mit dem Zahlungslink in der Nachricht angezeigt.
  • Funktion: Wählen Sie den Button-Typ Zahlung.
  • Funktionsfeld: Um einen Button zu erstellen, der einen Zahlungslink bereitstellt, wählen Sie die Funktion Zahlung.
  • Feld Zahlungssystem: Die Liste zeigt die mit dem Projekt verbundenen Zahlungssysteme an.

Abhängig vom gewählten Zahlungssystem variieren die erforderlichen Felder zur Generierung des Links und zur Erstellung der Quittung.

Die Einstellungen für den Button mit der Zahlungsfunktion für verschiedene Zahlungssysteme können Sie hier einsehen:

Die erforderlichen Felder zur Generierung des Zahlungslinks sind Betrag und Produktname/Produktbeschreibung.

  • Feld Betrag: Geben Sie hier den Zahlungsbetrag ein.
  • Feld Produktname: Geben Sie den Namen des Produkts ein, der auf der Zahlungsseite angezeigt wird.

Im Produktnamen dürfen keine doppelten Anführungszeichen verwendet werden.

Sie können diese durch Apostrophe oder einfache Anführungszeichen ersetzen.

Abhängig vom gewählten Zahlungssystem erscheinen in den Button-Einstellungen Dropdown-Menüs mit der Bezeichnung „Quittungsdaten“ und/oder „Zusätzliche Informationen“. Durch Klicken darauf werden zusätzliche Felder angezeigt:

Bild

Variablen bei Verwendung des Zahlungs-Buttons

Sobald der Benutzer den Block mit dem „Zahlungs“-Button erhält, werden automatisch die folgenden Client-Variablen erstellt:

  • System-Client-Variable __payments – diese Variable speichert den Zahlungsbetrag und die Kennung des generierten Zahlungslinks. Sie wird verwendet, um die Webhook-Antwort des Zahlungssystems zu identifizieren.

Die System-Client-Variable __payments darf nicht gelöscht oder geändert werden!

Die Client-Variable error_payment_button wird erstellt, wenn bei der Generierung des Zahlungs-Buttons ein Fehler auftritt.

Ihr Wert enthält entweder die Fehlermeldung oder die vom Zahlungssystem zurückgegebene Fehlerantwort.

Die Werte der Variablen werden aktiv (aktuell), wenn der Benutzer zum nächsten Block wechselt.

Umgang mit dem Ergebnis

Erfolgreiche Zahlung

Nach einer erfolgreichen Zahlung erhält der Bot einen Callback, der aus den ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems, dem Wort _success und dem durch ein Leerzeichen getrennten Zahlungsbetrag besteht. Beispiel: ovg58keefc_success 44, wobei:

  • ovg58keefc: die ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems
  • _success: das Ergebnis der Anfrage (erfolgreiche Zahlung)
  • 44: der Zahlungsbetrag

Callbacks (Benachrichtigungen) vom Zahlungssystem sind für den Benutzer nicht sichtbar. Sie werden nur im Tab Clients angezeigt und sind für den Operator sichtbar.

Anwendungsbeispiel: Schritt 1. Fügen Sie im Block mit dem Zahlungs-Button Buttons mit der Zahlungs-Funktion hinzu. Schritt 2. Geben Sie im Feld Verbindungsbedingung von diesem Block zum Block Erfolgreiche Zahlung den Callback an. Dies funktioniert auf die gleiche Weise, wenn Sie den Callback für erfolgreiche Zahlungen im Bedingungsfeld des Blocks Primäre Bedingungsprüfung angeben.

Hinweis! Auswahl des Übereinstimmungstyps — Exakte Übereinstimmung oder Schlüsselwortübereinstimmung.

Nützlicher Tipp

Um dem Kunden eine Benachrichtigung über eine erfolgreiche Zahlung zu senden, ohne seinen Fortschritt durch den Haupttrichter zu unterbrechen, erstellen Sie „Nicht-zustandsbezogene Blöcke mit Bedingungen“.

Zahlung mit Fehler

Wenn ein Zahlungsfehler auftritt, erhält der Bot einen Callback, der aus den ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems, dem Wort _fail und dem durch ein Leerzeichen getrennten Zahlungsbetrag besteht. Beispiel: ovg58keefc_fail 44, wobei:

  • ovg58keefc: die ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems
  • _fail: das Ergebnis der Anfrageverarbeitung — Zahlung fehlgeschlagen oder ein Fehler ist aufgetreten
  • 44: der Zahlungsbetrag

Dies hängt vom Zahlungssystem ab. Nicht alle Zahlungssysteme senden einen Callback bei Zahlungsfehlern.

Wenn der in den Button-Einstellungen angegebene Betrag von dem tatsächlich vom Kunden gezahlten Betrag abweicht, erhält der Bot einen Callback, der aus den ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems, dem Ausdruck _different_amounts und einer eindeutigen Zahlungs-ID, getrennt durch ein Leerzeichen, besteht. Beispiel: ovg58keefc_different_amounts 123456, wobei:

  • ovg58keefc: die ersten 10 Zeichen des geheimen Schlüssels des Zahlungssystems
  • _different_amounts: das Ergebnis der Anfrageverarbeitung (Zahlungsbetrag weicht vom Betrag im Link ab)
  • 123456: eindeutige Zahlungs-ID