Schritt 1: Account anlegen
Haben Sie schon einen payever Account? Falls nein, können Sie hier einen erstellen oder falls bereits vorhanden, hier einloggen.
Schritt 2: Zahlungsarten 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 auch die 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 Sofortüberweisung, Ratenkauf (DE), Rechnungskauf (DE), Direktüberweisung (angeboten von Santander DE, aber auch verfügbar in AT) und Ratenkredit (DE, AT) müssen Sie hier Ihre Zugangsdaten eingeben, die Sie von der Santander erhalten haben, und anschließend auf Verbinden klicken.
(Sofern noch kein Kontakt zur Santander besteht: Sie erreichen die deutsche Niederlassung der Santander Consumer Bank unter ecommerce@santander.de, die Österreichische unter sales.ecommerce@santanderconsumer.at).
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).
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
Wählen Sie in der Checkout App den Reiter Kanäle aus.
Klicken Sie auf + Hinzufügen.
Aus der nun erscheinenden Liste wählen Sie OXID 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
Suchen Sie das payever Plugin im OXID exchange Marktplatz und installieren Sie es in Ihrem OXID Shop.
Schritt 5: Einstellungen treffen
Loggen Sie sich in Ihr OXID-Backend ein und aktivieren Sie zunächst das payever Plugin. Klicken Sie dafür links auf Erweiterungen/Module. Suchen Sie payever und klicken Sie anschließend rechts auf Aktivieren.
Öffnen Sie nun die Einstellungen für das payever Plugin, indem Sie in der linken Navigationsleiste auf payever klicken. Tragen Sie hier die API Schlüssel aus Ihrem payever Konto (siehe Schritt 3) in die jeweiligen Felder (Business UUID, Client Secret und Client ID) ein, achten Sie darauf, dass der Arbeitsmodus "Live" eingeschaltet ist und speichern Sie diese Einstellungen (Klick auf Speichern rechts). Synchronisieren Sie die Einstellungen anschließend mit Ihrem payever Account durch einen Klick auf Einstellungen Synchronisieren.
Überprüfen Sie nun, ob alle Zahlarten aktiviert sind, die auch in Ihrem payever Konto aktiviert sind und die Sie Ihren Kunden anbieten wollen. Wählen Sie dafür in der linken Navigationsleiste Shopeinstellungen und anschließend Zahlungsarten. In dem sich öffnenden Menü können Sie dann die einzelnen Zahlungsarten aktivieren sowie zudem weitere Änderungen für die einzelnen Zahlarten vornehmen, wenn Sie möchten. Achten Sie allerdings beim Verlassen dieser Einstellungen darauf, dass Sie alle Änderung vorab speichern.
Schritt 6: Zahlarten bearbeiten
Nachdem Sie alle Zahlarten angepasst und gespeichert haben, können Sie diese in den Optionen bearbeiten. Dazu öffnen Sie z.B. im Reiter Shopeinstellungen die Option Versandsarten und klicken im sich nun öffnenden Fenster auf Standard. Anschließend klicken Sie auf den Reiter Zahlungsarten und schließlich auf Zahlungsarten zuordnen.
Per drag and drop kann die gewünschte Zahlart hinüber gezogen werden.
TIPP: Das Plugin Testen
Möchten Sie das Plugin zunächst testen? Kein Problem - dafür gibt es den sogenannten Sandbox-Modus, in dem Transaktionen durchgeführt werden können, ohne dass eine abschließende Zahlungsabwicklung erfolgt. Um den Sandbox-Modus zu aktivieren, ändern Sie in den Einstellungen des payever Plugins den Modus auf "Sandbox" und rufen Sie automatisch unsere Testdaten ab, mit einem Klick auf Richten Sie Sandbox-API-Schlüssel. Alternativ finden Sie unsere Testdaten für die Felder Business UUID, Client Secret und Client ID hier: https://docs.payever.org/resources/de/test-credentials
Achten Sie allerdings darauf, nach dem Testen den Arbeitsmodus wieder auf "Live" zu schalten und anstelle der Testdaten die Daten (Business UUID, Client Secret, Client ID) aus Ihrem payever Account zu hinterlegen (und zu speichern). Ansonsten erhalten Sie eine Fehlermeldung. Die Testdaten funktionieren nur im Sandbox-Modus und die im payever Account selbst erzeugten API Schlüssel nur im Live-Modus.
Achtung: Sie verwenden die Zahlungsarten "Santander Rechnungskauf" oder "Santander Ratenkauf"?
Wenn Sie den Rechnungskauf oder Ratenkauf der Santander verwenden, fügen Sie bitte Ihrer Rechnung an den Kunden die entsprechenden Überweisungsdaten der Santander hinzu - so wird sichergestellt, dass der Kunde nicht versehentlich an Sie statt an Santander überweißt. Der Kunde erhält zwar später nochmal eine separate Email der Santander mit den Überweisungsdaten, aber insbesondere bei der Zahlart "Rechnungskauf" denken viele Kunden, dass die von Ihnen gesendete Rechnung das entscheidende Dokument ist. Wenn dort nun Ihre eigenen Überweisungsdaten oder gar keine Überweisungsdaten/ Informationen zur Überweisung stehen, kann dies die Kunden verwirren. Daher befolgen Sie bitte die folgenden Anweisungen:
In Ihrem Rechnungs-Template (oder andern Templates, die die Variable $order enthalten), dass Sie i.d.R. unter CUSTOMER INFO > CMS PAGES finden sollten, kopieren Sie bitte folgenden Code an der entsprechende Stelle ein:
[{if $order->oxorder__panid->value}]
Sie haben bei dieser Bestellung eine Zahlungsart der Santander gewählt. In Kürze erhalten Sie von der Santander eine Email mit allen Informationen zu den weiteren Schritten und Zahlungsfristen. Bitte achten Sie darauf, das Geld nicht an uns, sondern an das unten angegebene Konto der Santander zu überweisen und dabei den folgenden Verwendungszweck anzugeben:<br>
Empfänger: Santander Consumer Bank AG<br>
IBAN: DE89 3101 0833 8810 0761 20<br>
BIC: SCFBDE33XXX<br>
Betrag: [{ $order->oxorder__oxtotalordersum->value|number_format:2:",":"" }] [{ $order->oxorder__oxcurrency->value }] <br>
Verwendungszweck: [{ $order->oxorder__panid->value }]<br>
[{/if}]
Nach der Integration: Hinweise zur Abwicklung von Zahlungen
Generell sind unsere Plugins so konzipiert, dass alle im payever Account verfügbaren Aktionen auch aus Ihrem Shopware Backend heraus angestoßen werden können. In der Regel brauchen Sie sich also nicht in Ihren payever Account einzuloggen, um sich übe den Status einer Zahlung zu informieren oder z.B. eine Zahlung zu stornieren!
Statusmeldungen - der Zahlungsstatus IN_PROCESS tritt i.d.R. nur beim Ratenkredit auf und bedeutet, dass die Zahlung noch nicht vollständig ist (Kunde muss noch einen Identifizierungsprozess durchlaufen und/oder Dokumente nachreichen). Wenn Sie diesen Status sehen, warten Sie bitte ab und versenden Sie die Ware noch nicht. Der Status OK bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden. Der Status DECLINED bedeutet, dass die Zahlung fehlgeschlagen ist, abgelehnt wurde oder durch Sie storniert (auch hier keine Ware versenden).
Capture/ Warenversand - Bitte beachten Sie, das bei einigen unserer Zahlungsarten (definitiv bei Rechnungskauf, Ratenkauf und Ratenkredit, ggf. auch PayPal und Kreditkarte, sofern Sie sich dort in den Einstellungen gegen ein automatisches Capture entschieden haben), den Warenversand melden müssen. Öffnen Sie dazu bitte die Bestellungen verwalten > Bestellungen und klicken auf die betroffenen Transaktion und dann auf "Jetzt versenden". (Nur für Santander Ratenkredit Österreich gilt: Senden Sie regelmäßig Ihre Rechnungen an teilzahlung@santanderconsumer.at, um die Auszahlungen des Kreditbetrags zu erhalten.)
Stornierungen - Wenn Sie eine Transaktion erstatten möchten, öffnen Sie bitte die Bestelldetails (Bestellungen verwalten> Bestellungen)und klicken Sie auf das Symbol unter dem Mülleimer (Eintrag stornieren). Bestätigen Sie nur noch mit OK und Sie sollten im unteren Abschnitt die Stornierung gelistet haben.
Bitte beachten Sie dabei aber, dass nicht alle unsere Zahlarten über eine automatische Stornierungsfunktion verfügen: Den Ratenkredit Deutschland können Sie nur vor dem Warenversand über payever/Shopware stornieren (danach nur händisch per Email an cfs-abrechnung@santander.de), Direktüberweisungen und Lastschriften können nur über eine Rücküberweisung an den Kunden von Ihrem Bankkonto aus erstattet werden. Außerdem haben nicht alle Zahlarten sowohl Storno- als auch Erstattungs-Funktion, einige haben nur jeweils eines davon (Sofortüberweisung und Kreditkarte nur Erstattung, Ratenkredit Deutschland nur Stornierung).
Noch Fragen oder Probleme?
Sie erreichen unseren kostenlosen Support Montags bis Freitags zwischen 8 und 19 Uhr unter support@payever.de
Bitte teilen Sie uns in Ihrer Nachricht mit, welche Shopware und Plugin-Version Sie verwenden, um welchen Shop (URL und/oder Email-Adresse mit der Sie bei uns registriert sind) es bei Ihrer Anfrage geht und welche Fehlermeldung/Störung Sie an welcher Stelle bemerkt haben - so können wir Ihr Anliegen schneller bearbeiten!