Ogone

Ogone, auch bekannt als Ingenico Payment Services, ist ein in Frankreich ansässiges Unternehmen, das die Technologie für sichere elektronische Transaktionen bereitstellt.

Warnung

Der Anbieter Ogone ist veraltet. Es wird empfohlen, stattdessen Stripe zu verwenden.

Einstellungen in Ogone

Einen API-Benutzer erstellen

Melden Sie sich bei Ihrem Ogone-Konto an und wechseln Sie zum Reiter Konfiguration.

Sie müssen einen API-Benutzer anlegen, der für die Erstellung von Transaktionen aus Odoo verwendet wird. Sie können dazu zwar Ihr Hauptkonto verwenden, aber die Verwendung eines API-Benutzers stellt sicher, dass im Falle eines Lecks der in Odoo verwendeten Anmeldedaten kein Zugriff auf Ihre Ogone-Konfiguration möglich ist. Außerdem müssen die Passwörter für API-Benutzer im Gegensatz zu normalen Benutzern nicht regelmäßig aktualisiert werden.

Um einen API-Benutzer zu erstellen, gehen Sie zu Configuration ‣ Users (Konfiguration –> Benutzer) und klicken Sie auf New User (Neuer Benutzer). Die folgenden Felder müssen konfiguriert werden:

  • UserID (Benutzer-ID): Sie können auswählen, was Sie möchten.

  • User’s Name, E-mail and Timezone (Name des Benutzers, E-Mail und Zeitzone): Sie können die gewünschten Informationen eingeben.

  • Profile (Profil): sollte Admin sein.

  • Special user for API (spezieller Benutzer für API): sollte angekreuzt werden.

Nach der Erstellung des Benutzers müssen Sie ein Passwort generieren. Speichern Sie das Passwort und die Benutzer-ID, da Sie diese später bei der Einrichtung benötigen.

Tipp

Wenn Sie bereits einen Benutzer eingerichtet haben, vergewissern Sie sich, dass er ohne Fehler aktiviert ist. Falls nicht, klicken Sie einfach auf die Schaltfläche Activate(Errors) (Aktivieren(Fehler)), um den Benutzer zurückzusetzen.

Ogone für Odoo einrichten

Ogone muss nun so konfiguriert werden, dass es Zahlungen von Odoo akzeptiert. Gehen Sie zu Configuration –> Technical Information –> Global Security Parameters (Konfiguration –> Technische Informationen –> Globale Sicherheitsparameter), wählen Sie SHA-512 als Hash Algorithm (Hash-Algorithmus) und UTF-8 als character encoding (Zeichenkodierung). Wechseln Sie dann den Reiter Data and Origin verification (Daten- und Herkunftsverifizierung) auf derselben Seite und lassen Sie das URL-Feld im Abschnitt e-Commerce and Alias Gateway (E-Commerce und Alias-Gateway) leer.

Tipp

Wenn Sie in Odoo einen anderen Algorithmus, wie z. B. sha-1 oder sha-256, verwenden möchten, aktivieren Sie den Entwicklermodus und gehen Sie zu die Seite Zahlungsanbieter in Buchhaltung –> Konfiguration –> Zahlungsanbieter. Klicken Sie auf Ogone und wählen Sie im Reiter Anmeldedaten den Algorithmus, den Sie im Feld Hash-Function (Hash-Funktion) verwenden möchten.

Sie müssen nun SHA-IN-Passphrasen erstellen. Die SHA-IN- und SHA-OUT- Passphrasen werden verwendet, um die Transaktionsanfragen und -antworten zwischen Odoo und Ogone digital zu signieren. Durch die Verwendung dieser geheimen Passphrasen und des sha-1-Algorithmus können beide Systeme sicherstellen, dass die Informationen, die sie von der jeweils anderen Seite erhalten, nicht verändert oder verfälscht wurden.

Geben Sie dieselbe SHA-IN-Passphrase sowohl in Checks for e-Commerce & Alias Gateway (Prüfungen für E-Commerce und Alias-Gateway) als auch in Checks für DirectLink and Batch (Automatic) (Prüfungen für DirectLink and Batch (Automatic)) ein. Sie können das Feld IP-Adresse leer lassen.

Ihre SHA-IN- und SHA-OUT-Passphrasen sollten unterschiedlich und zwischen 16 und 32 Zeichen lang sein. Stellen Sie sicher, dass Sie in der gesamten Ogone-Konfiguration dieselben SHA-IN- und SHA-OUT- Passphrasen verwenden, da Odoo nur eine einzige SHA-IN- und eine einzige SHA-OUT-Passphrase erlaubt.

Um den SHA-OUT-Schlüssel abzurufen, melden Sie sich in Ihr Ogone-Konto an, gehen Sie zu Configuration ‣ Technical Information ‣ Transaction feedback ‣ All transaction submission modes (Konfiguration –> Technische Informationen –> Transaktionsfeedback –> Alle Transaktionseinreichungsmodi) und holen Sie sich Ihren API-Schlüssel und Client-Schlüssel oder generieren Sie ihn. Achten Sie darauf, Ihren API-Schlüssel zu kopieren, da Sie ihn später nicht mehr abrufen können, ohne einen neuen zu generieren.

Wenn Sie fertig sind, gehen Sie zu Configuration ‣ Technical Information ‣ Transaction Feedback (Konfiguration –> Technische Informationen –> Transaktionsfeedback) und aktivieren Sie die folgenden Optionen:

  • Die Felder URL für HTTP redirection in the browser (HTTP-Umleitung im Browser) können leer gelassen werden, da Odoo diese URLs für jede Transaktionsanfrage angibt.

  • I would like to receive transaction feedback parameters on the redirection URLs (Ich möchte Parameter für Transaktionsrückmeldungen auf den Umleitungs-URLs erhalten): sollte angekreuzt werden.

  • Direct HTTP server-to-server request (Direkte HTTP-Anfrage von Server zu Server): sollte auf Online but switch to a deferred request when the online request fails (Online, aber Wechsel zu einer aufgeschobenen Anfrage, wenn die Online-Anfrage fehlschlägt) gesetzt werden.

  • Beide URL-Felder sollten dieselbe folgende URL enthalten, wobei <example> durch Ihre Datenbank ersetzt wird: https://<example>/payment/ogone/return.

  • Dynamic eCommerce Parameters (Dynamische E-Commerce-Parameter) sollten die folgenden Werte enthalten: ALIAS, AMOUNT, CARDNO, CN, CURRENCY, IP, NCERROR ORDERID, PAYID, PM, STATUS, TRXDATE. Andere Parameter können einbezogen werden (wenn Sie eine andere Integration mit Ogone haben, die diese benötigt), werden aber nicht empfohlen.

  • Geben Sie im Abschnitt All transaction submission modes (Alle Transaktionsübermittlungsmodi) die Passphrase SHA-OUT ein und deaktivieren Sie HTTP request for status change (HTTP-Anfrage für Statusänderung).

Um Ihren Kunden die Möglichkeit zu geben, ihre Kreditkartendaten zur späteren Verwendung zu speichern, gehen Sie zu Configuration ‣ Alias ‣ My alias information ( Konfiguration –> Alias –> Meine Alias-Informationen). In diesem Reiter können Sie konfigurieren, wie der Benutzer seine Kartendaten speichern kann, wie lange die Daten gespeichert werden, ob ein Kontrollkästchen zum Speichern der Kartendaten angezeigt werden soll usw.

Einstellungen in Odoo

Um Ogone in Odoo einzurichten, gehen Sie zu Buchhaltung ‣ Konfiguration ‣ Zahlungsanbieter und öffnen Sie den Ogone-Anbieter. Geben Sie auf den Reiter Anmeldedaten die PSPID Ihres Ogone-Kontos ein und füllen Sie die anderen Felder aus, wie in Ihrem Ogone-Portal konfiguriert.