Dokumentation

1Das Grundkonzept der Prozessoren

Es ist wichtig, ein klares Verständnis der verschiedenen Begriffe und ihrer Bedeutung zu haben. Besonders wichtig ist, dass Sie den Unterschied verstehen und wissen, wie diese Konzepte zueinander in Beziehung stehen. Insbesondere den Unterschied zwischen Zahlart, Prozessor und Connector.

1.1Anatomie

Damit eine Zahlart auf der Zahlungsseite erscheint, müssen die folgenden Entitäten korrekt konfiguriert werden:

  • Prozessor: Ein processor stellt eine einzelne Integration zu einem Drittanbieter dar, der Zahlungen verarbeiten kann. Für jeden processor muss eine Konfiguration erstellt werden, um Zahlungen über den processor zu akzeptieren.

  • Zahlart: Eine payment method stellt ein einzelnes Mittel dar, mit dem ein Kunde bezahlen kann. Eine payment method kann auch konfiguriert werden, um bestimmte Eigenschaften der payment method zu steuern. Um Zahlungen mit einer bestimmten Zahlart zu akzeptieren, muss eine Konfiguration für diese payment method erstellt werden.

  • Connector: Ein connector verknüpft die payment method mit dem processor. Er ist wie eine einzelne Verbindung zum processor. Ein processor verfügt über eine feste Menge von connectors. Um einen connector zu verwenden, muss er konfiguriert werden. Der connector führt die Zahlung tatsächlich aus, und daher benötigen Sie die connector-Konfiguration, um Zahlungen zu akzeptieren.

Für jede dieser Entitäten können Sie natürlich mehrere Konfigurationen haben. Sie können auch mehrere Konfigurationen desselben Typs haben und sie durch Bedingungen trennen oder mit einer bestimmten Space-Ansicht verknüpfen.

1.2Prozessor

Sie können eine Prozessor-Konfiguration unter Space > Zahlung > Konfiguration > Verarbeiter erstellen.

Ein Prozessor stellt die API-Integration zu einem Drittanbieter dar. Die Prozessorliste zeigt alle unterstützten Prozessoren.

In der Prozessor-Konfiguration können Sie im Allgemeinen die folgenden Einstellungen festlegen:

  • Aktivieren oder Deaktivieren der Prozessor-Konfiguration. Wenn die Prozessor-Konfiguration deaktiviert ist, werden alle mit der Prozessor-Konfiguration verknüpften Connector-Konfigurationen nicht mehr für die Autorisierung von Transaktionen berücksichtigt. Eine deaktivierte Konfiguration kann wieder aktiviert werden.

  • Wechseln zwischen Live- und Testmodus.

  • Festlegen der Zugangsdaten, um die API des Prozessors zu verwenden. Dies sind z.B. die vom Prozessor bereitgestellten Zugangsdaten.

Sie können mehrere Instanzen desselben Prozessors haben. Dies erlaubt die Verwendung mehrerer Konten desselben Prozessors. So können abhängig von einer Transaktionseigenschaft (z.B. Betrag, Land usw.) unterschiedliche Konten verwendet werden.

Beispiel

Verschiedene Terminals basierend auf einem bestimmten Kriterium verwenden:

Wenn Sie abhängig von einem Transaktionskriterium (z.B. dem Transaktionsbetrag) einen anderen Prozessor verwenden möchten, können Sie die Bedingungen auf die jeweilige Connector-Konfiguration anwenden (siehe unten), um den richtigen Zahlungsdienstleister auszuwählen.

1.3Zahlarten

Um eine Konfiguration für eine Zahlart zu erstellen, gehen Sie zu Space > Zahlung > Konfiguration > Zahlarten.

Eine Zahlarten-Konfiguration definiert, wie die Zahlung verarbeitet wird. Wir unterstützen eine Vielzahl unterschiedlicher Zahlarten. Beachten Sie, dass nicht jede Zahlart von jedem Prozessor verarbeitet werden kann. Die Zahlartenliste zeigt alle unterstützten Zahlarten.

In der Zahlarten-Konfiguration können Sie im Allgemeinen die folgenden Einstellungen festlegen:

  • Aktivieren und Deaktivieren einer Zahlarten-Konfiguration. Wenn eine Zahlarten-Konfiguration deaktiviert ist, wird diese Zahlarten-Konfiguration nicht mehr für die Autorisierung von Transaktionen verwendet. Eine deaktivierte Konfiguration kann wieder aktiviert werden.

  • Definieren des Namens der Zahlart, der dem Kunden angezeigt wird.

  • Definieren der Reihenfolge, in der die Zahlart dem Kunden angezeigt wird.

  • Definieren des Bildes, das für die Zahlart verwendet wird.

  • Einige Zahlarten erlauben die Erfassung der Zahlungsinformationen direkt auf unserer Zahlungsseite. In diesem Fall können Sie auswählen, ob Sie die Daten lieber auf der Zahlungsseite des Drittanbieters erfassen lassen (offsite) oder ob wir die Daten erfassen sollen (onsite). Diese Option erscheint nur, wenn Sie dies für eine bestimmte Zahlart steuern können. Nicht alle Payment-Connectors unterstützen beide Arten der Datenerfassung, daher sollten Sie zuerst prüfen, ob Ihr bevorzugter Connector die gewählte Art der Datenerfassung unterstützt. Sobald die Art der Datenerfassung in einer Zahlarten-Konfiguration festgelegt wurde, kann sie nicht mehr geändert werden.

Sie können mehrere Konfigurationen derselben Zahlart erstellen.

1.4Connector-Konfigurationen

Um eine Connector-Konfiguration zu erstellen, gehen Sie zu Space > Zahlung > Konfiguration > Connectors.

Eine Connector-Konfiguration verknüpft die Eigenschaften der Zahlarten mit den Fähigkeiten Ihres Prozessors (d.h. nicht jede Zahlart kann von jedem Zahlungsprozessor verarbeitet werden. Einige Prozessoren können bestimmte Zahlarten nur offsite bzw. nur onsite verarbeiten).

Die verfügbaren Einstellungen hängen stark von den Fähigkeiten des Connectors und den Eigenschaften der Zahlart ab.

In der Zahlarten-Konfiguration können Sie im Allgemeinen die folgenden Einstellungen festlegen:

  • Aktivieren und Deaktivieren der Connector-Konfiguration. Eine deaktivierte Connector-Konfiguration wird nicht für die Autorisierung von Transaktionen berücksichtigt. Eine deaktivierte Konfiguration kann wieder aktiviert werden.

  • Die Reihenfolge, in der die Connectors auf Transaktionen angewendet werden.

  • Die Bedingungen, die auf den Connector angewendet werden. Damit können Sie steuern, unter welchen Umständen der Connector verwendet wird.

  • Einschränken des Connectors auf eine Menge von Space-Ansichten.

  • Die E-Mail-Vorlage für die Autorisierung und die E-Mail-Vorlage für die Rechnung.

  • Die Rechnungsvorlage, die für Transaktionen dieses Connectors angewendet wird.

  • Connector-spezifische Einstellungen wie beispielsweise Betrugseinstellungen.

Um Ihre konfigurierte Zahlart mit dem Prozessor zu verknüpfen, können Sie für jeden Ihrer vorgesehenen Fälle eine separate Connector-Konfiguration erstellen.

Beispiel

Verschiedene Terminals basierend auf einem bestimmten Kriterium verwenden

Wenn Sie abhängig von einem Transaktionskriterium (z.B. dem Transaktionsbetrag) einen anderen Prozessor verwenden möchten, können Sie mehrere Konfigurationen erstellen und dann die Bedingungen in der jeweiligen Connector-Konfiguration anwenden.

2Bedingungen auf Connectors anwenden

Bedingungen sind unser Weg, eine Connector-Konfiguration für eine Transaktion auszuwählen. Sie können Bedingungskonfigurationen unter Space > Zahlung > Konfiguration > Bedingungen erstellen.

Bedingungen können auf Basis mehrerer Transaktionskriterien festgelegt werden. Die Liste der Bedingungstypen zeigt alle möglichen Typen. Jeder Typ definiert unterschiedliche Kriterien, wie Transaktionen gefiltert werden. Diese Bedingungen können auch in einer logischen or-Gruppe zusammengefasst werden. Dies erlaubt die Formulierung komplexer Bedingungen.

Bedingungen werden zentral verwaltet, da sie auf mehrere Konfigurationen angewendet werden können, wie zum Beispiel:

  • Connector-Konfiguration: Die Bedingungen wirken hier als Mechanismus für das Routing von Transaktionen.

  • Charge-Flow-Konfiguration: Die Bedingungen steuern, welcher Flow auf die Transaktion angewendet wird.

Note
Wenn nach der Anwendung einer Bedingung noch mehrere Optionen übrig bleiben, erfolgt die Auswahl anhand der in der Konfiguration definierten Priorität. Die Anwendung von Bedingungen und die Priorität erlauben es, ein Routing von Transaktionen festzulegen.

3Erfassung der Zahlungsdaten

Die Zahlungsinformationen können entweder über unser gehostetes Zahlungsformular erfasst werden (onsite), oder wir können den Kunden zur Datenerfassung zum Prozessor weiterleiten (offsite).

  • Onsite-Datenerfassung bedeutet, dass das Formular zur Datenerfassung von uns generiert wird und daher durch Bearbeiten der entsprechenden Formularelemente über den Ressourcen-Editor angepasst werden kann.

  • Offsite-Datenerfassung bedeutet, dass die Anpassung des Formulars über die Möglichkeiten des Prozessors erfolgen muss.

Note
Einige Zahlarten unterstützen nur die eine oder die andere Erfassungsart. In diesem Fall kann die Zahlarten-Konfiguration entweder für die offsite- oder die onsite-Datenerfassung eingerichtet werden. Das bedeutet, dass Sie je nach Einrichtung der Zahlarten-Konfiguration möglicherweise nicht jeden Prozessor auswählen können, wenn Sie Ihre Connector-Konfiguration einrichten.