Dokumentation

1Datatrans Registrierungsdokumentation

Die Registrierungsdokumentation erklärt, wie Sie Ihr eigenes Datatrans-Konto erhalten. Dies ist eine Voraussetzung, um mit der Abwicklung von Transaktionen zu beginnen.

1.1Beantragen eines Datatrans-Händlerkontos

Bevor Sie mit der Zahlungsannahme über Datatrans beginnen können, benötigen Sie ein Datatrans- Konto. Sie erhalten dieses Konto unter der folgenden URL: https://www.datatrans.ch/.

1.2Zugriff auf das Administrationskonto

Sobald Datatrans ein Konto für Sie erstellt hat, erhalten Sie ein Test- und ein Live-Konto sowie die folgenden Zugangsdaten:

  • Datatrans Test- & Live-Merchant-ID

  • Benutzername

  • Passwort

Diese Informationen sind erforderlich, um sich im Administrations-Backend anzumelden. Nachfolgend finden Sie die URL zur Test- und Live-Umgebung.

Über das Administrationskonto können Sie die Transaktionen einsehen, Benutzerkonten erstellen und weitere administrative Vorgänge durchführen.

1.3Testen

Um Ihre Integration zu testen, können Sie zwei Strategien verfolgen:

  1. Entweder Sie erstellen eine Prozessorkonfiguration und konfigurieren die Testdetails und stellen den Betriebsmodus auf Test. Nachdem Sie die Integration erfolgreich getestet haben, tauschen Sie die Einstellungen für das Live-Konto aus.

  2. Sie können zwei Prozessorkonfigurationen erstellen, eine für Live und eine für Test. Sobald Ihre Tests erfolgreich sind, deaktivieren Sie die Prozessor- und Connector-Konfigurationen für den Test und stellen sicher, dass Sie die Live- Konfiguration verwenden.

Weitere Informationen zu Teststrategien finden Sie in der Zahlungsdokumentation.

Weitere Testkarten für Datatrans finden Sie in der Dokumentation.

Note
Stellen Sie sicher, dass Sie in den Live-Modus wechseln, da Transaktionen im Testmodus nicht verarbeitet werden.

2Datatrans-Konfigurationsdokumentation

Die folgende Dokumentation führt Sie durch die notwendigen Schritte zur Einrichtung der Datatrans-Prozessor- und Connector-Konfiguration.

2.1Die Prozessorkonfiguration einrichten

Um den Datatrans-Verarbeiter einzurichten, befolgen Sie die folgenden Schritte sorgfältig. Gehen Sie zu Space > Zahlung > Konfiguration > Verarbeiter und fügen Sie den Verarbeiter hinzu. Suchen Sie im Dropdown-Feld nach Datatrans.

2.1.1Die Datatrans Merchant ID einrichten

Zunächst müssen Sie die Datatrans Merchant ID festlegen, die Sie oben auf Ihrem Login-Bildschirm finden. Es handelt sich normalerweise um eine 10-stellige Zahl wie diese 1100005635. Live-Konten beginnen normalerweise mit einer 3 und Testkonten mit einer 1.

2.1.2Die Sicherheitskonfiguration und den Hash einrichten

Wechseln Sie in den Tab UPP Administration > Security und klicken Sie auf Security signature, um die Hashes einzurichten:

  1. Klicken Sie auf Generate New Key, um einen neuen HMAC zu generieren

  2. Aktivieren Sie das Kontrollkästchen, um einen anderen Schlüssel für sign2 zu verwenden, und generieren Sie einen sign2-HMAC

  3. Kopieren Sie den Schlüssel in Ihre Prozessorkonfigurationseinstellungen und speichern Sie die Einstellungen im Datatrans-Konto.

UPP Security
Figure 1. UPP Security Settings

2.1.3Server-to-Server-Schutz einrichten

Wechseln Sie in den Tab UPP Administration > Security:

  1. Aktivieren Sie das Kontrollkästchen für "Protect server-to-server services with password"

  2. Kopieren Sie das Passwort in die Einstellung Basic Authentication der Prozessorkonfiguration.

Note
Sobald Sie den Server-to-Server-Schutz aktiviert haben, ist es nicht möglich, diese Funktion zu deaktivieren. Wenn diese Option aktiviert ist und das Passwort nicht am Verarbeiter gesetzt ist, wird die Verbindung blockiert und die Zahlungsanfrage kann nicht abgeschlossen werden, da der Zugriff verweigert wird.

2.1.4UPP-Einstellungen

Um die UPP-Daten für die Zahlungsbenachrichtigung zu konfigurieren, wechseln Sie in den Tab UPP Administration > UPP Data. Hier können Sie Ihre URL Post für die Benachrichtigung über Zahlungstransaktionen definieren. Alle Felder außer URL Post sollten mit none ausgefüllt werden.

UPP Data Settings
Figure 2. UPP Data Settings

2.1.5Wiederkehrende Zahlungen

Falls Sie den Datatrans-Verarbeiter in Verbindung mit wiederkehrenden Zahlungen und Abonnements verwenden möchten, benötigen Sie ein dediziertes Händlerkonto von Datatrans, bei dem die Alias-Option aktiviert ist.

Um dies zu tun, setzen Sie die Einstellung Recurring Account so, dass ein dediziertes Konto verwendet wird, und konfigurieren Sie das Konto für wiederkehrende Zahlungen wie oben beschrieben.

2.1.6MoTo-Zahlungen

Sie können den Datatrans-Verarbeiter verwenden, um Mail- und Telefonbestellungen zu erstellen, um Kunden direkt am Telefon zu belasten. Setzen Sie die Moto-Konfiguration auf aktiviert und konfigurieren Sie das Konto genau wie oben beschrieben.

2.2Eine Zahlart erstellen

Falls noch nicht geschehen, müssen Sie eine Zahlart für alle Zahlungsarten erstellen, die Sie über Datatrans akzeptieren möchten. Navigieren Sie dazu zu Space > Konfiguration > Verarbeiter > Zahlarten.

Create the payment methods.
Figure 3. Erstellen Sie die Zahlart-Typen für Ihr Konto.

2.3Die Datatrans-Connectors erstellen

Zu guter Letzt müssen Sie die Zahlart mit der Prozessorkonfiguration zu einer Connector-Konfiguration verknüpfen. Navigieren Sie dazu zu Space > Konfiguration > Verarbeiter > Connector und erstellen Sie eine neue Connector-Konfiguration. Stellen Sie sicher, dass Sie jeden Zahlart-Typ, den Sie über die Anwendung verarbeiten möchten, mit dem Datatrans-Verarbeiter verknüpfen.

Weitere Informationen zum Prozessorkonzept und dessen Funktionsweise finden Sie in unserer Zahlungsdokumentation.

Create the connector configurations.
Figure 4. Erstellen Sie die Connector-Konfigurationen für Ihr Konto.