Magento 2

Haben Sie bereits Magento 1? Bitte wechseln Sie zu dieser Anleitung.

 

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 Zahlungsarten im Reiter Zahlungsarten an der linken Navigationsleiste.

Klicken Sie auf + Hinzufügen.

Nun erscheint eine Liste an verschiedenen Zahlungsarten, die Sie nach Bedarf auswählen können. Klicken Sie hierfür auf installieren.

Nachdem Sie die Zahlungsart 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 Zahlungsart 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 Zahlungsart.

Unabhängig von der Zahlaungsrt, 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 Magento 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 in Magento installieren

Wie Sie Ihr Plugin am Besten installieren hängt auch davon ab, wie Sie Magento 2 selbst installiert haben. Wenn Sie Magento 2 über CLI installiert haben, müssen Sie auch das Plugin über CLI installieren, haben Sie Magento 2 über Admin installiert, haben Sie die freie Wahl, ob Sie lieber über CLI oder Admin installieren möchten.

Eine Anleitung, wie Sie Plugins über CLI installieren, finden Sie hier bei Magento. Für die Installation mittels Admin folgen Sie bitte dieser Anleitung. 

Nachdem Sie das payever Plugin auf die eine oder andere Art und Weise installiert haben, kehren Sie bitte zu dieser Anleitung hier zurück und fahren Sie mit Schritt 5 fort (wenn Sie hyvä nicht nutzen). 

 

Wenn Sie hyvä verwenden...

...installieren Sie bitte zusätzlich hyvä in unserer Connect-App und laden Sie das Plugin (1.0.0) herunter, indem Sie diesen Schritten folgen:

Öffnen Sie auf Ihrem Dashboard die Connect-App:

Wählen Sie Shopsysteme in der Navigation auf der linken Seite, suchen Sie nach hyvä und klicken Sie auf Installieren:

Im Pop Up klicken Sie bitte auf Öffnen:

Im nächsten Pop Up laden Sie bitte das Plugin (1.0.0) herunter, indem Sie auf Download klicken:

HINWEIS: Erstellen Sie keine API Keys für hyvä, diese werden zu keinem Zeitpunkt benötigt!

Klicken Sie anschließend in der oberen rechten Ecke des Pop Ups auf Fertig. Nun können Sie mit der Konfiguration von Magento (mit Schritt 5) fortfahren.

 

Schritt 5: Magento Plugin konfigurieren

Um das Plugin zu konfigurieren, gehen Sie bitte zu Stores -> Configuration -> Sales -> Payment Methods und klicken Sie bei payever auf Configure.

Nun treffen Sie einige Einstellungen: 

• Umgebung / (Environment):  Wählen Sie bitte Live aus (es sei denn Sie möchten zunächst einige Testtransaktionen durchführen, in diesem Fall wählen Sie bitte Sandbox aus - mehr Informationen dazu finden Sie am Ende dieser Anleitung). 
• Client ID, Client Secret und Business UUID: Hier geben Sie bitte die Daten ein, die Sie in Schritt 3 in Ihrem payever Account generiert haben (es sei denn Sie befinden sich im Sandbox-Modus, in diesem Fall klicken Sie bitte den Button Sandbox API Schlüssel einsetzen). 
• Symbol für Zahlart anzeigen / (Display payment icon): Hier können Sie festlegen, ob neben der Zahlart ein Icon/Logo angezeigt werden soll (je nach Zahlungsart unterschiedlich - Sie sehen eine Vorschau der Logos unterhalb des payever Beschreibungstextes auf dieser Seite).
• Beschreibung für Zahlart anzeigen / (Display payment description): Hier können Sie festlegen, ob unter der Zahlart ein kurzer Erklärungstext eingeblendet werden soll. Wenn Sie hier Yes wählen, vergessen Sie bitte anschließend nicht, im folgenden Schritt 6 dieser Anleitung einen entsprechenden sinnvollen Beschreibungstext zu hinterlegen).
• Integrationsart / (Mode Integration): Hier können Sie wählen zwischen den Optionen Iframe und Weiterleitung zu payever. Wenn Sie hier Iframe wählen, wird der payever Checkout in einem Bereich/Iframe innerhalb Ihrer Webseite geladen, der Kunde verlässt Ihren Shop nicht. Wählen Sie Weiterleitung zu payever wird der Kunde hierfür auf ein neues Fenster mit einer payever URL weitergeleitet. I.d.R. empfiehlt sich hier die Einstellung Iframe (wird von der überwiegenden Mehrzahl der Kunden und Händler bevorzugt). Achtung: Falls Sie einen sog. "One-Step Checkout" verwenden, können Sie ggf. nur den Redirect nutzen. 
• Sprache / (Locale): Hier wählen Sie entweder die Sprache Ihres Shops (z.B. Deutsch) oder die Einstellung Automatisch - diese bewirkt, dass payever automatisch die Sprache wählt, die im Browser dieses Kunden eingestellt ist. 
• Logging Level: Hier gibt es die Optionen Info, Debugging und Error. Im Modus Info werden die Basics der Transaktionen sowie Fehlermeldungen geloggt, bei Error nur die Fehlermeldungen. Den Modus Debugging brauchen Sie nur dann zu aktivieren, wenn Sie später einmal ein technisches Problem haben und wir Sie darum bitten, den Debugging Modus zu aktivieren und uns anschließend die log files zukommen zu lassen (Button Download Log File). 
• Locking Type: In der Regel passt hier die Einstellung File Lock, es sei denn Sie haben eine Cluster Umgebung, in diesem Fall verwenden Sie bitte MySQL Lock, um die ungewollte Duplizieren von Bestellungen zu vermeiden. 

Wenn Sie alles wie gewünscht eingestellt haben, klicken Sie bitte zunächst Save Config und dann Zahlungsarten synchronisieren.

 

Schritt 6: Einzelne Zahlarten konfigurieren

Anschließend können Sie noch Einstellungen an den einzelnen Zahlarten vornehmen. Scrollen Sie dazu nach unten, Sie finden die Zahlarten dort unterhalb des Zahlungsarten synchronisieren Buttons aufgelistet. 

• Titel und Beschreibung:  Das sind der Name und der Info-Text, den Ihre Kunden anschließend im Checkout sehen werden.
• Zahlungsoption: Steuert das Zahlungsverhalten (wann wird autorisiert, wann gecaptured) bei Magento. In unserem Plugin ist diese Option nahezu bedeutungslos - bei einem Teil unserer Zahlarten kann der Zeitpunkt des Capture gar nicht geändert werden (bei den Santander Zahlarten findet das capture immer automatisch dann statt, wenn die Versand-Dokumente erstellt werden), bei anderen (z.B. PayPal) wird diese Einstellung über den payever Account (Checkout App -> Zahlarten -> z.B. PayPal) gesteuert. 
• Automatische Abbuchung: Bei Yes wird die Rechnung automatisch erstellt, sobald die Zahlung akzeptiert wurde, bei No wird die Rechnung nicht automatisch erstellt.  
• Min. Order Total und Max. Order Total: Der Mindestwert des Warenkorbs, ab dem die Zahlart angezeigt wird, und der Maximalwert des Warenkorbs, ab dem die Zahlart ausgeblendet wird. Bitte beachten Sie, dass jede Zahlart von unserer Seite aus bzw. von Seiten des Zahlungsanbieters bereits einen Mindest- und Maximalwert hat (insbesondere zu beachten bei den Santander Zahlarten). Sie können den Spielraum überdies hinaus noch weiter eingrenzen, indem Sie einen Betrag überhalb des Mindest- und unterhalb des Maximum-Betrags eintragen, aber Sie können den Spielraum nicht eigenmächtig vergrößern, indem Sie hier einen niedrigeren Mindestbetrag oder einen höheren Maximalbetrag eingeben (im Beispiel unten würde Ihnen die Zahlart trotzdem nur bis 750€ angezeigt, auch wenn Sie hier 2000 eingeben). 

Wenn Sie alle Zahlarten konfiguriert haben, vergessen Sie bitte nicht, erneut auf Save Config zu klicken!

 

Schritt 7: Cache bereinigen

Nach dem Speichern der Konfigurationen fällt Ihnen vermutlich am oberen Rand der Seite folgende Meldung auf (in gelb): 

Bitte ignorieren Sie diese Meldung nicht, sondern gehen Sie dem Hinweis nach und klicken Sie auf die Verlinkung in der Warnmeldung. Dies führt Sie zur Seite Cache Management.

Setzen Sie ein Häkchen neben Configuration und Page Cache und klicken Sie anschließend auf Submit. Dieser Schritt ist erforderlich, damit Sie Ihre Änderungen (z.B. an den Bezeichnungen und Beschreibungstexten der Zahlarten) im Frontend Ihres Shops anschließend auch sehen können!

 

Schritt 8: Frontend überprüfen

Nun können Sie nachsehen, ob Sie die Zahlarten wie gewünscht angezeigt bekommen (inklusive Icon, Benennung und Beschreibung) und ob die Weiterleitung zu payever funktioniert. Wenn alles stimmt, sollte das Resultat in etwa so aussehen (Screenshot zeigt den Iframe-Modus): 

Bitte schließen Sie aber, solange Sie im Live-Modus sind, keine Zahlungen ab, da dies zu einer echten Transaktion führt und somit Gebühren anfallen. Wenn Sie den Abschluss und die Verarbeitung von Transaktionen testen wollen, befolgen Sie bitte die Anweisungen im nächsten Absatz und wechseln in den Sandbox-Modus. 

 

Das Plugin Testen: der Sandbox-Modus

Möchten Sie das Plugin zuerst testen? Bitte aktivieren Sie dazu unter Umgebung den Sandbox Modus und klicken Sie auf den Button Sandbox API Schlüssel einsetzen. Nun Speichern Sie Ihre Konfigurationen ab (Save Configs) und klicken auf Zahlungsarten synchronisieren. Im Sandbox-Modus werden Sie nicht mit Ihrem eigenen payever Account verbunden, sondern mit unserem generellen Test-Account - deswegen bekommen Sie hier nun auch alle verfügbaren Zahlarten angezeigt, nicht nur die, die Sie in Ihrem payever Account aktiviert haben (Sie werden diese Test Transaktionen auch nicht in Ihrem payever Account sehen). 

Um die Bezahlung im Testmodus bestätigt zu bekommen, nutzen Sie bitte die entsprechenden Test-Daten, die Sie hier finden können.

Nun können Sie das Plugin testen, ohne dabei eine echte Transaktion auszulösen. Wir möchten Sie bitten, ausschließlich im Sandbox Modus zu testen, da Test-Transaktionen in Live, auch wenn Sie diese anschließend umgehend stornieren, ungewünschte Folgen haben können (testen Sie z.B. zu oft mit Ihrer Kreditkarte kann diese ggf. gemeldet und gesperrt werden, stellen Sie mehrfach Ratenkredit-Anträge auf Ihren Namen, kann dies Ihren Schufa-Score verschlechtern, etc.). 

 

Wenn Sie mit Testen fertig sind und live gehen möchten:

• Vergessen Sie bitte nicht, die Testdaten zu entfernen und stattdessen Ihre eigenen Daten aus Ihrem payever Account (siehe Schritt 3) einzutragen, zu speichern und anschließend zu synchronisieren (sonst erhalten Sie beim Synchronisieren eine Fehlermeldung). Sie können weder Ihre Live-Daten im Sandbox-Modus nutzen, noch können Sie unsere Testdaten in Live  verwenden! 
• Beachten Sie außerdem, dass getroffene Einstellungen (Plugin-Einstellungen, Namen und Texte der Zahlarten, etc.) beim Wechsel zwischen Live- und Sandbox-Modus (egal in welche Richtung) verloren gehen. Mit jedem Synchronisierungs-Vorgang setzen Sie diese Einstellungen automatisch zurück - wenn Sie also im Sandbox-Modus alles konfiguriert haben, zufrieden sind und somit live gehen wollen, merken Sie sich bitte, was Sie eingestellt hatten, und wiederholen Sie diese Einstellungen nochmal, nachdem Sie in den Live-Modus gewechselt und synchronisiert haben. 

Hinweis für die Zahlungsarten Santander Rechnungskauf und 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. 

Per Default fügen wir mit Installation des Plugins folgende Bemerkung zu Ihrer Rechnung hinzu: 

(Deutsch) Verwendungszweck: {{var payeverPanId}}
(Englisch) Payment reference: {{var payeverPanId}}

Wobei {{var payeverPanId}} der individuelle Verwendungszweck dieser Transaktion ist, die der Kunde bei seiner Überweisung angeben muss. 

Es empfiehlt sich allerdings, den kompletten Satz Überweisungsdaten sowie eine kurze Erläuterung einzufügen. Dafür öffnen Sie bitte den Pfad MARKETING > Communications > Email Templates und geben dort folgenden Code ein:

{{if payeverPanId}} 
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: 
{{var order.getGrandTotal()}} 
<br> 
Verwendungszweck: {{var payeverPanId}}<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 Magento 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 Zahlungsprüfung/ Payment Review 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 Verarbeitung/Processing bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden. Der Status Cancelled/Abgebrochen 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 Bestelldetails ( > Sales > Orders > bei der betroffenen Transaktion auf „View“ klicken). Dort nun in der Detailansicht der Bestellung rechts oben auf Invoice klicken. (Nur für Santander Ratenkredit Österreich gilt zusätzlich: Senden Sie regelmäßig Ihre Rechnungen an teilzahlung@santanderconsumer.at, um die Auszahlungen des Kreditbetrags zu erhalten.)

Auf der sich nun öffnenden Seite New Invoice befindet sich ganz rechts unten der Button Submit Invoice, der die Versandmeldung auslöst. Im Anschluss erscheint untenstehende Erfolgsmeldung und der Magento-Status wechselt zu Completed.

Erstattungen - Wenn Sie eine Transaktion erstatten möchten, öffnen Sie dazu bitte die Invoice Details ( > Sales > Invoices > bei der betroffenen Transaktion auf „View“ klicken). Dort nun in der Detailansicht der Bestellung rechts oben auf Credit Memo klicken. 

Auf der sich nun öffnenden Seite New Memo for... befindet sich ganz rechts unten der Button Refund (Achtung, nicht Refund Offline!), der die Erstattung auslöst. Wenn Sie nur einen Teil der Bestellung erstatten möchten, tragen Sie zunächst bei den Artikeln, die nicht erstattet werden sollen, als Menge „0“ ein, klicken Update Quantities und klicken dann erst Refund.

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!