Odoo unterstützt Tausende von Unternehmen in ganz Europa – von aufstrebenden KMUs bis hin zu mittelständischen Einzelhändlern, die ihren gesamten Betrieb über eine einzige Plattform verwalten. Diese Händler können die Zahlungs-App von payever direkt in Odoo 17–19 aktivieren.
Schritt 1: Konto registrieren
Erstellen Sie sich hier, sofern Sie das noch nicht getan haben, Ihren kostenlosen payever Account. Sollten Sie bereits einen Account haben können Sie sich hier einloggen.
Schritt 2: Zahlungsoptionen konfigurieren
Um zu den Zahlungsarten zu gelangen, öffnen Sie zunächst die Checkout App. Klicken Sie dazu entweder auf das Checkout-Symbol in der Kachel Business Apps oder auf Öffnen in der Kachel Checkout.
Sie finden die Zahlarten im Reiter Zahlarten an der linken Navigationsleiste.
Klicken Sie auf + Hinzufügen.
Nun erscheint eine Liste an verschiedenen Zahlarten, die Sie nach Bedarf auswählen können. Klicken Sie hierfür auf installieren.
Nachdem Sie die Zahlart erfolgreich installiert haben, klicken Sie auf Öffnen, um gegebenenfalls die Zugangsdaten einzugeben. Dies können Sie auch zu einem späteren Zeitpunkt unter dem Reiter Connect > Settings konfigurieren.
Nun öffnet sich eine Schaltfläche, deren Aufbau sich je nach Zahlungsart unterschiedlich gestaltet.
Bei den Zahlungsarten Kreditkarte, Lastschrift und Paypal klicken Sie einfach den Verbinden Button und werden zum jeweiligen Anbieter weitergeleitet. Dort verknüpfen Sie entweder Ihren bestehenden Account bei diesem Anbieter, oder erstellen sich einen neuen.
Bei den Zahlungsarten Ratenkauf (DE), Rechnungskauf (DE,NO), Openbank Pay (DE, ES), Direktüberweisung (DE, AT, CH) und Ratenkredit (DE, AT, DK, NO, SE, FI) müssen Sie hier Ihre Zugangsdaten eingeben, die Sie vom Zahlungsanbieter erhalten haben, und anschließend auf Verbinden klicken.
Die Zugangsdaten können je nach Zahlart ganz unterschiedlich aussehen (von nur einem Zahlen/Buchstaben-Code bis hin zu vier ist alles möglich) - Details dazu finden Sie in der Anleitung zur jeweiligen Zahlart.
Unabhängig von der Zahlart, achten Sie bitte darauf, Ihre Zugangsdaten stets in den Reiter Standard bzw. Default einzutragen. Klicken Sie nicht auf + Hinzufügen und tragen dort die Zugangsdaten ein (dies müssen Sie nur dann, wenn Sie für einen besonderen UseCase mehrere Paare Zugangsdaten für die gleiche Zahlart haben - auch in diesen Fällen müssen Sie aber immer erst die Default/Standart-Variante mit Zugangsdaten befüllen, bevor Sie weitere hinzufügen können).
Unabhängig von der Zahlart, achten Sie bitte darauf, Ihre Zugangsdaten stets in den Reiter Standard bzw. Default einzutragen. Klicken Sie nicht auf + Hinzufügen und tragen dort die Zugangsdaten ein (dies müssen Sie nur dann, wenn Sie für einen besonderen UseCase mehrere Paare Zugangsdaten für die gleiche Zahlart haben - auch in diesen Fällen müssen Sie aber immer erst die Default/Standart-Variante mit Zugangsdaten befüllen, bevor Sie weitere hinzufügen können).
Nachdem Sie die Zahlarten verbunden haben, können Sie an der Zahlart noch eine oder mehrere Einstellungen treffen - welche genau das jeweils sind und was diese zu bedeuten haben, entnehmen Sie bitte ebenfalls unserer Dokumentation zu der betroffenen Zahlungsart, welche Sie hier finden können.
Schritt 3: Kanal einrichten
Nachdem Sie sich bei payever registriert und die gewünschten Zahlungsoptionen eingerichtet haben, wählen Sie in der Checkout-App die Registerkarte „Kanäle“ aus.
Klicken Sie auf + Hinzufügen.
Aus der nun erscheinenden Liste wählen Sie Odoo aus und klicken Sie auf Installieren.
Nun müssen Sie auf Öffnen klicken, damit Sie im nächsten Schritt die API-Schlüssel generieren können.
1. Wählen Sie den Reiter API Schlüssel und klicken Sie auf + Hinzufügen.
2. Geben Sie dem API Schlüssel einen beliebigen Namen und klicken Sie auf Erstellen.
3. Klicken Sie nun auf das + Symbol.
4. Sie sehen nun die Daten, die Sie später in Ihrem Shop System eingeben müssen (Client ID, Client Secret und Business UUID). Bitte kopieren Sie sich diese in die Zwischenablage.
Schritt 4: Plugin installieren
Melden Sie sich bei Ihrem Odoo-Konto an, öffnen Sie den Bereich Apps und navigieren Sie zu Third-Party Apps (Apps von Drittanbietern).
Suchen Sie nach „payever“ und klicken Sie auf das payever Checkout-Plugin.
Das payever-Checkout-Plugin lässt sich in Odoo in der Regel auf zwei Arten installieren, je nach Ihrer Hosting-Konfiguration: über Odoo.sh oder über eine lokale Installation. Odoo.sh ist die offizielle Cloud-Lösung von Odoo für das Hosting und die Verwaltung von Anwendungen. Bei lokalen Installationenmüssen die Plugin-Dateien hingegen direkt auf Ihrem Server abgelegt werden. Links zu Anleitungen für beide Installationsmethoden finden Sie unten:
Schritt 5: Mit payever verbinden
Sobald Sie unser Plugin installiert haben, melden Sie sich in Ihrem Odoo-Backend an, gehen Sie zu Settings (Einstellungen) und Payment Provider (Zahlungsanbieter), wählen Sie „payever“ aus und aktivieren Sie es.
Sie können nun die Zugangsdaten für Ihren Odoo-Shop einrichten. Wie im ersten Schritt beschrieben, finden Sie diese in Ihrem CommerceOS-Konto unter Connect -> Shop Systems -> Odoo. Kopieren Sie die Zugangsdaten und fügen Sie sie in Odoo unter Settings (Einstellungen) -> payment provider (Zahlungsanbieter) -> payever -> (Credentials) Zugangsdaten ein.
- State (Status): Bitte setzen Sie den Zahlungsanbieter auf Enabled (Aktiviert). Wenn Sie zunächst Testtransaktionen durchführen möchten, wählen Sie stattdessen den Testmodus. Weitere Informationen zum Testen finden Sie am Ende dieses Artikels.
- Client-ID, Client-Secret und Business-UUID: Bitte geben Sie die API-Anmeldedaten, die Sie in Ihrem payever-Konto generiert haben, in die entsprechenden Felder ein, es sei denn, Sie verwenden den Sandbox-Modus.
- Debug Logging (Debug-Protokollierung): Wenn diese Option aktiviert ist, werden zusätzliche technische Protokolldaten aufgezeichnet, um Fehler und Integrationsprobleme zu analysieren. Diese Option sollte normalerweise nur zu Zwecken der Fehlerbehebung aktiviert werden.
Sobald Sie alle erforderlichen Informationen eingegeben haben, klicken Sie auf Sync Payment Methods from payever (Zahlungsmethoden synchronisieren).
Schritt 6: Zahlungsoptionen bearbeiten
Nachdem Sie die Zahlungsmethoden synchronisiert haben, können Sie diese in Ihren Einstellungen konfigurieren. Gehen Sie dazu zu Configuration (Konfiguration) -> payment form (Zahlungsform) und wählen Sie die Zahlungsmethode aus, die Sie bearbeiten möchten. Hier können Sie die Zahlungseinstellungen und -limits konfigurieren und festlegen, ob Zahlungen manuell oder automatisch erfasst werden sollen. Ausführlichere Informationen zu diesen Optionen finden Sie weiter unten in diesem Artikel. Vergessen Sie nicht, auf Speichern zu klicken, wenn Sie fertig sind.
Testen des Plugins: der Sandbox-Modus
Möchten Sie das Plugin und die Zahlungsoptionen testen, bevor Sie live gehen? Kein Problem – Sie können dies im Staging-/Sandbox-Modus tun, da keine der Transaktionen, die Sie in diesem Modus durchführen, zu einer tatsächlichen Zahlung führt. Wir bitten Sie, keine Tests außerhalb des Sandbox-Modus durchzuführen, da das Testen von Zahlungen im Live-Modus unbeabsichtigte Folgen haben kann – selbst wenn Sie die Transaktion unmittelbar nach dem Absenden stornieren (wenn Sie zu oft mit Ihrer eigenen Kreditkarte testen, kann diese gesperrt werden, und wenn Sie beispielsweise zu viele Ratenzahlungsanträge über Santander unter Ihrem Namen stellen, kann sich dies negativ auf Ihre Bonität auswirken).
Um den Staging-/Sandbox-Modus zu aktivieren, stellen Sie in den Einstellungen des payever-Plugins den Status auf Test Mode (Testmodus) ein und geben Sie die Test-Anmeldedaten ein (Business-UUID, Client-Secret, Client-ID). Um sicherzustellen, dass Ihre Testtransaktionen akzeptiert werden, verwenden Sie bitte Stub-Daten.
Sobald Sie die Tests abgeschlossen und auf den Live-Betrieb umgestellt haben (State (Status) = Enabled (Aktiviert)), vergessen Sie bitte nicht, Ihre eigenen Live-Anmeldedaten (Business-UUID, Client-Secret, Client-ID) einzugeben, anschließend zu speichern und zu synchronisieren (ansonsten erhalten Sie eine Fehlermeldung).
Wenn Sie mit dem Testen fertig sind und live gehen möchten:
- Bitte vergessen Sie nicht, die Testdaten zu entfernen und stattdessen Ihre eigenen Daten aus Ihrem payever-Konto einzugeben, zu speichern und anschließend zu synchronisieren (ansonsten erhalten Sie beim Synchronisieren eine Fehlermeldung). Sie können Ihre Live-Daten nicht im Sandbox-Modus verwenden, ebenso wenig wie unsere Testdaten im Live-Modus!
- Bitte beachten Sie auch, dass alle vorgenommenen Einstellungen (Plug-in-Einstellungen, Namen und Texte der Zahlungsmethoden usw.) beim Wechsel zwischen Live- und Sandbox-Modus (unabhängig von der Richtung) verloren gehen. Mit jeder Änderung setzen Sie diese Einstellungen zurück – wenn Sie also alles im Sandbox-Modus konfiguriert haben, zufrieden sind und daher live gehen möchten, merken Sie sich bitte die von Ihnen vorgenommene Konfiguration und wiederholen Sie diese Einstellungen im Live-Modus. Sobald die Konfiguration erneut vorgenommen wurde, denken Sie bitte daran, auf Synchronisieren zu klicken.
Nach der Integration: Hinweise zur Zahlungsabwicklung
Generell sind unsere Plugins so konzipiert, dass alle im payever-Konto verfügbaren Aktionen auch über Ihr Odoo-Backend ausgelöst werden können. In der Regel müssen Sie sich nicht in Ihr payever-Konto einloggen, um beispielsweise den Status einer Zahlung abzurufen oder eine Zahlung zu stornieren!
Statusberichte – Der Zahlungsstatus InProgress (In Bearbeitung) tritt in der Regel nur bei Ratenkrediten auf und bedeutet, dass die Zahlung noch nicht abgeschlossen ist (der Kunde muss noch einen Identifizierungsprozess durchlaufen und/oder erforderliche Dokumente einreichen). Wenn Sie diesen Status sehen, warten Sie bitte ab und versenden Sie die Ware noch nicht an Ihren Kunden. Der Status Akzeptiert (Accepted) bedeutet, dass die Zahlung erfolgreich und abgeschlossen wurde – in diesem Fall können Sie die Ware an Ihren Kunden versenden. Der Status Cancelled (Storniert) bedeutet, dass die Zahlung fehlgeschlagen ist, abgelehnt wurde oder von Ihnen storniert wurde (auch hier gilt: Versenden Sie bei diesem Status keine Ware an Ihren Kunden).
Erfassung / Warenversand
Bitte beachten Sie, dass Sie bei einigen unserer Zahlungsmethoden, wie z. B. Rechnungszahlung und Ratenkredit, sowie möglicherweise auch bei PayPal und Kreditkarte – sofern die automatische Erfassung für die jeweilige Zahlungsoption in den Einstellungen deaktiviert wurde – bestätigen müssen, dass die Ware versandt wurde.
Dies muss jedoch nicht manuell erfolgen. Es reicht aus, den Status der entsprechenden Bestellung in Odoo auf Completed paid (Abgeschlossen und bezahlt) zu setzen, sobald die Ware versandt wurde.
Im folgenden Screenshot sehen Sie, wie Sie die automatische Erfassung in Odoo konfigurieren können. Aktivieren Sie das Kontrollkästchen, wenn Sie die manuelle Erfassung aktivieren möchten.
Noch Fragen oder Probleme?
Sie erreichen unseren kostenlosen Support Montags bis Freitags zwischen 8 und 17 Uhr unter support@payever.de
Bitte teilen Sie uns in Ihrer Nachricht mit, welches Shopsystem und welche Plugin-Version Sie verwenden, um welchen Shop es bei Ihrer Anfrage geht (URL und/oder E-Mail-Adresse, mit der Sie bei uns registriert sind) und welche Fehlermeldung bzw. Störung Sie an welcher Stelle bemerkt haben. So können wir Ihr Anliegen schneller bearbeiten. Schicken Sie uns gerne auch Screenshots mit, die uns helfen, die Problematik besser nachzuvollziehen.