Dokumentation

1Einführung in Charge Flows

Charge Flows werden verwendet, wenn Sie Ihren Kunden belasten möchten. Abhängig von der Zahlart entscheiden wir dann, ob wir den Kunden direkt belasten können oder ob wir eine E-Mail, SMS usw. versenden müssen, um seine Zahlungsdaten zu erfassen. Wie und wann dies geschieht, kann in den Charge Flow Levels festgelegt werden.

1.1Anwendungsfälle für Charge Flows: Wiederkehrende Zahlungen

Wiederkehrende Zahlungen sind ein interessantes Konzept für Kundenbindung und Komfort, insbesondere im E-Commerce-Bereich. Charge Flow ist ein Konzept, das Sie einsetzen können, wenn Sie Waren verkaufen und steuern möchten, wann ein Kunde belastet werden soll. In diesem Fall können Sie über die API eine Transaktion mit dem Token erstellen (siehe unten für weitere Details). Die Anwendung versucht nun, das angegebene Token zu belasten. Schlägt dies fehl, stellt der Charge-Flow-Prozess sicher, dass Ihr Kunde kontaktiert wird, um die Zahlungsinformationen zu aktualisieren, was Ihren Aufwand für die Umsetzung wiederkehrender Prozesse erheblich reduziert.

Important
Falls Sie Abonnements für digitale Güter verkaufen möchten, werfen Sie einen Blick auf unsere Abonnement-API, mit der Sie Produkte erstellen und verschiedenste Preis- und Abrechnungsmethoden umsetzen können.

1.2Anwendungsfall für Charge Flows: Zahlungslinks per E-Mail

Sie können Charge Flows auch für Ihre Callcenter- / Webshop-Integration verwenden, wann immer Sie Zahlungsinformationen asynchron erfassen möchten. Das heisst, Sie möchten Ihren Kunden eine E-Mail senden, die einen Zahlungslink aus Ihrem Shop enthält, um die Zahlungsinformationen nicht direkt am Telefon zu erfassen. Dies hat für Sie den grossen Vorteil, dass Sie Transaktionsgebühren sparen, da MoTo-Transaktionen teurer sind, und dass Sie Zahlungen mit allen möglichen Zahlarten verarbeiten können. Charge Flows erinnern Ihre Kunden dann automatisch, abhängig von Ihren Charge Flow Levels (siehe unten).

2Charge Flows und Charge Flow Levels

Wir unterscheiden drei verschiedene Arten, den Kunden zu belasten. Charge Flows und Charge Flow Levels können unter Space > Konfiguration > Charge Flows eingerichtet werden.

Sie müssen zuerst einen Charge Flow einrichten und diesem anschliessend die verschiedenen Levels zuordnen. Die Charge Flow Levels definieren den Prozess, wie Sie den Kunden belasten möchten und wie Sie, falls die Belastung fehlschlägt, die Zahlungsinformationen von ihm einholen möchten.

2.1Verschiedene Arten, wie ein Kunde belastet werden kann

Wir bieten Ihnen drei Möglichkeiten, wie Sie den Kunden belasten oder die Zahlungsinformationen einholen können, falls die Belastung fehlschlägt oder die Zahlungsinformationen noch nicht erfasst wurden.

  • Verwendung eines Tokens: Ein Token stellt im Wesentlichen eine Referenz auf in der Plattform gespeicherte Zahlungsinformationen dar. Falls einem Kunden ein gültiges Token zugeordnet ist, können wir das Token verwenden, um den Kunden direkt zu belasten.

  • Asynchrone Belastung: Einige Zahlarten erlauben es, den Kunden ohne dessen Interaktion zu belasten. Alles, was Sie benötigen, sind die relevanten Zahlungsinformationen (z. B. um eine Rechnung zu versenden). In diesem Fall können wir den Kunden ebenfalls mit den vorhandenen Informationen belasten.

  • Versand eines Links: Falls keiner der oben genannten Mechanismen funktioniert, wird dem Kunden ein Link gesendet. Der Link verweist auf die Zahlungsseite. Dort kann der Kunde eine beliebige konfigurierte Zahlart auswählen und die Transaktion abschliessen. Wie und wann dieser Link gesendet wird, wird in den Charge Flow Levels festgelegt. Siehe auch Zustellung des Zahlungslinks.

Die Charge-Flow-Konfiguration definiert, wie genau die oben genannten Strategien angewendet werden. Sie können die Konfigurationen nach Bedarf anpassen.

2.2Token

Ein Token stellt eine Referenz auf gespeicherte Zahlungsinformationen dar. Werfen Sie einen Blick auf die Dokumentation zur Tokenisierung, um zu erfahren, wie Token verwendet und auf Transaktionen angewendet werden können.

2.3Einen Charge Flow erstellen

Ein Charge Flow kann im Backoffice erstellt werden. Gehen Sie zu Space > Zahlung > Konfiguration > Charge Flows und klicken Sie auf Charge Flow, um einen hinzuzufügen.

2.4Charge Flow Levels verwalten

Die Charge Flow Levels kommen nur zum Einsatz, wenn kein oder kein gültiges Token vorhanden ist und die asynchrone Belastung nicht möglich war. Sie bestimmen, wie und wann die Transaktionsinformationen erfasst werden. Sobald der Charge Flow erstellt ist, können Sie ein Charge Flow Level erstellen. Im Charge Flow Level können Sie den Type festlegen, der definiert, wie der Kunde benachrichtigt wird. Abhängig vom Type haben Sie die Möglichkeit, zusätzliche Einstellungen vorzunehmen.

Sie können beliebig viele Charge Flow Levels erstellen. Bei der Verarbeitung des Charge Flows werden alle Levels berücksichtigt, bis der Kunde die Zahlungsinformationen erfolgreich bereitgestellt hat und sich die Transaktion im Zustand Fulfill befindet. Der Belastungsversuch gilt als Failed, sobald alle Charge Flow Levels erfolglos verarbeitet wurden.

2.5Auswahlprozess für Charge Flows

Sie haben die Möglichkeit, mehrere Charge Flows für verschiedene Anlässe zu erstellen. Sie können den verschiedenen Charge Flows unter Space > Zahlung > Konfiguration > Bedingungen Bedingungen zuweisen. Um die Charge-Flow-Konfiguration zu bestimmen, werden die folgenden Schritte durchgeführt:

  • Die relevanten Charge Flows werden durch Anwendung aller konfigurierten Bedingungen ermittelt.

  • Die Priorität der aktuellen Level-Konfiguration wird ausgewählt.

  • Alle Level-Konfigurationen eines bestimmten Flows werden aufsteigend sortiert.

  • Wir wählen die Level-Konfiguration mit der nächsthöheren Priorität gegenüber derjenigen der aktuellen Level-Konfiguration aus.

Important
Die Priorität gibt die Sortierreihenfolge der Level-Konfigurationen an. Ein niedriger Wert bedeutet, dass die Level-Konfiguration vor allen Levels mit einem höheren Wert ausgeführt wird. Jede Änderung dieses Werts wirkt sich auf zukünftige Auswahlen der Level-Konfiguration aus. Das heisst, wenn Sie die Priorität ändern, wird die Sortierreihenfolge neu bewertet, sobald das nächste Level fällig ist.

3Charge Flows verwenden

Charge Flows können über das Backend oder über die API ausgelöst werden.

3.1Charge Flows aus dem Backoffice auslösen

Sie können Transaktionen aus der Anwendung heraus unter Space > Zahlung > Transaktion > Erstellen erstellen. Sie können die relevanten Transaktionsinformationen direkt in Ihrem Browser angeben.

Chare Flows
Figure 1. So erstellen Sie eine Transaktion ohne anwesenden Kunden mit Charge Flows.

3.2Charge Flows über die API auslösen

Charge Flows können auf Transaktionen im Zustand pending angewendet werden. Sie müssen lediglich eine Transaktion mit dem Transaction Create Service erstellen.

Sobald die Transaktion erstellt ist, können Sie die Operation Apply Flow des Charge Flow Service verwenden, um die Belastung über einen Charge Flow auszulösen. Dies startet nun den oben beschriebenen Belastungsprozess.

4Zustellung des Zahlungslinks

Ein Charge Flow besteht aus verschiedenen Levels. Jedes Level kann seinen eigenen Typ haben. Der Typ definiert, ob und wie der Zahlungslink dem Kunden zugestellt wird. Der Typ ist nur relevant, wenn die Belastung nicht erfolgreich war und der Kunde Zahlungsdaten angeben muss, um die Transaktion abzuschliessen.

Es existieren die folgenden Zustellungstypen:

  • Email: Der Level-Typ Email sendet den Zahlungslink per E-Mail an den Kunden. Voraussetzung ist eine auf der Transaktion definierte E-Mail-Adresse. Um diese Zustellungsoption zu nutzen, muss die E-Mail-Funktion aktiviert sein.

  • No Action: Dieser Typ verhindert die Zustellung des Zahlungslinks, sodass versucht werden kann, den Kunden mit einem Token zu belasten, ohne Massnahmen zu ergreifen, falls die Belastung fehlschlägt. Dies ist nützlich für Wiederholungsstrategien. Bei einigen Zahlarten und in einigen Ländern sind Wiederholungen sinnvoller, als den Kunden sofort über den Fehlschlag zu informieren.

  • External Application: Der Typ External Application erlaubt es, die Übermittlung des Zahlungslinks an den Kunden an eine externe Anwendung zu delegieren. Die externe Anwendung muss einen Webhook für die Entität Charge Flow Level Payment Link registrieren. Wann immer ein Charge Flow Level die Übermittlung eines Zahlungslinks erfordert, wird eine solche Entität erstellt und die Webhook-URL aufgerufen. Die externe Anwendung, die auf die URL hört, kann die Web-Service-API verwenden, um den Zahlungslink abzurufen. Die externe Anwendung übermittelt den Link dann an den Kunden.