Haben Sie bereits Shopware 6? Bitte wechseln Sie zu dieser Anleitung.
Schritt 1: Account anlegen
Haben Sie schon einen payever Account? Falls nicht, können Sie sich hier einen erstellen. Wenn Sie bereits einen payever Account haben, können Sie sich 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 auf Öffnen in der Kachel Checkout.
Sie finden die Zahlungsarten in der linken Navigationsleiste.
Klicken Sie auf Hinzufügen.
Nun erscheint eine Liste von 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 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 Account.
Bei den Zahlungsarten Sofortüberweisung, Ratenkauf (DE), Rechnungskauf (DE), Direktüberweisung (angeboten von Santander DE, aber auch verfügbar in AT (Österreich)) 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 Codes ist alles möglich) - Details dazu finden Sie in der Anleitung zur jeweiligen Zahlart.
Unabhängig von der Zahlungsart 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 Use-Case mehrere Paare von Zugangsdaten für die gleiche Zahlungsart haben - auch in diesen Fällen müssen Sie aber immer erst die Default/Standart-Variante mit Zugangsdaten ausfüllen, bevor Sie weitere hinzufügen können).
Nachdem Sie die Zahlungsarten verbunden haben, können Sie an der Zahlungsart noch eine oder mehrere Einstellungen vornehmen - 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 bitte Shopware.
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 + Plus-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
Bevor Sie sich in Ihren Shopware Account einloggen achten Sie bitte darauf, Ihre präferierte Sprache auszuwählen.
Wenn Sie sich erfolgreich eingeloggt haben, klicken Sie auf den Reiter Einstellungen und wählen Sie aus den erscheinenden Optionen den Plugin Manager aus.
Im Plugin Manager angekommen (bitte beachten Sie, dass Sie hierfür eingeloggt sein müssen), geben Sie bitte in das Suchfenster oben links payever ein. Klicken Sie nun auf Install, um das Plugin zu installieren.
In einigen Fällen werden Sie nun aufgefordert zu bestätigen, dass das Cache geleert werden darf. Bitte antworten Sie mit Ja.
Sollten Sie das Pop-up nicht angezeigt bekommen, können Sie das Cache auch manuell leeren, unter > Einstellungen > Caches /Performance > Shop Cache leeren.
Schritt 5: Verknüpfung mit payever herstellen
Aktivieren Sie zunächst das Plugin, indem Sie auf Aktivieren klicken (Sie werden erneut gebeten die Leerung des Caches zu bestätigen, antworten Sie bitte mit Ja).
Nun treffen Sie einige Einstellungen:
- Sandbox: Wählen Sie bitte Nein aus (es sei denn, Sie möchten zunächst einige Testtransaktionen durchführen, in diesem Fall wählen Sie bitte Ja aus - mehr Informationen dazu finden Sie am Ende dieser Anleitung).
- Iframe: Hier empfehlen wir die Einstellung Ja. Wenn Sie hier Ja wählen, wird der payever Checkout in einem Bereich/Iframe innerhalb Ihrer Webseite geladen und der Kunde verlässt Ihren Shop nicht. Wählen Sie Nein wird der Kunde hierfür auf ein neues Fenster mit einer payever URL weitergeleitet. Bitte beachten Sie, dass nicht bei allen Zahlarten eine Darstellung im Iframe möglich ist (einige Zahlarten wie z.B. PayPal unterstützen dies nicht) - bei diesen Zahlarten leiten wir unabhängig davon, was Sie hier ausgewählt haben, immer automatisch auf eine neue Seite weiter.
- Umleitung zum Zahlungsgateway erzwingen: Diese Einstellung betrifft Sie, wenn Sie eine oder mehrere Redirect-Zahlarten nutzen (Zahlarten, bei denen payever nicht das User Interface stellt - konkret sind das Zinia, Santander Österreich, Santander Niederlande, Santander Finnland, Klarna Sofortüberweisung und PayPal) - Sie sollten in diesem Fall Ja wählen. Wenn Sie Nein wählen, wird der Kunde immer erst zu payever und von dort zur Seite des Zahlungsanbieters weitergeleitet, wenn Sie hingegen Ja wählen, wird der Kunde direkt ohne Umwege auf die Seite des Zahlungsanbieters weitergeleitet.
- Senden Sie Protokolle über APM: Wir empfehlen, dass Sie hier Ja anwenden.
- Logging: Hier empfehlen wir die Einstellung Critical Payment Data (kritische Zahlungsdaten). Die beiden anderen Optionen brauchen Sie in der Regel nicht, es sei denn bei Ihnen treten im späteren Verlauf Probleme auf - dann bittet unser Support Sie ggf., den Modus Zahlungsdaten und Debugging Data zu aktivieren, damit wir die Problemursachen besser analysieren können.
- 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).
- Widget-Einstellungen: Widgets sind Elemente, die interaktiv genutzt werden können, wie z. B. ein Paybutton oder ein Ratenrechner (Weitere Informationen finden Sie hier: Widgets & Ratenrechner). Wenn Sie kein Widget auf Ihrer Seite anzeigen möchten, sind diese Einstellungen für Sie irrelevant.
Wenn Sie jedoch ein Widget verwenden möchten, müssen Sie das Dropdown-Menü unter Express-Widget-Typ öffnen und auswählen, welches Widget Sie anzeigen möchten. Unter Widget-Designstil können Sie im Drop-Down-Menü auswählen, ob das Overlay unseres Checkouts in einer hellen oder dunklen Version angezeigt werden soll. In den nächsten beiden Feldern können Sie auf das Dropdown-Menü klicken und einstellen, ob Sie das Widget auf der Produktseite und/oder auf der Warenkorbseite anzeigen lassen möchten. - Bestellstatus für gezahlte Zahlung: Hier können Sie auswählen, bei welchem Bestellstatus ein Capture- bzw. Aktivierungsaufruf für die zugehörige Zahlung an payever gesendet werden soll. Normalerweise sollte dies ein Status sein der signalisiert, dass die Bestellung ausgeführt bzw. versendet wurde, damit dem Kunden nichts abgebucht oder in Rechnung gestellt wird, bevor die Bestellung bearbeitet wurde.
- Icon für Zahlart: Hier können Sie festlegen, ob neben der Zahlart ein Icon/Logo angezeigt werden soll (je nach Zahlart unterschiedlich).
- Checkout Sprache: Hier wählen Sie entweder die Sprache Ihres Shops oder die Einstellung Standard - diese bewirkt, dass payever automatisch die Sprache wählt, die im Browser des jeweiligen Kunden eingestellt ist.
- Abgelehnte Transaktionen speichern: Hier können Sie auswählen, ob Sie Bestellungen, die vom Zahlungsanbieter abgelehnt wurden, in Ihrem Shopware Backend angezeigt bekommen wollen. Hier empfehlen wir die Einstellung Nein.
- Auffüllen bei fehlgeschlagener Zahlung: Wählen Sie hier Ja, füllt unser Plugin automatisch die entsprechenden Artikel wieder im Bestand auf, wenn eine Bestellung aufgrund einer abgelehnten Zahlung nicht ausgeführt werden kann. Wir empfehlen Ja zu wählen, damit der Bestand korrekt getrackt wird und Ware, die am Ende doch nicht an den Kunden versendet wird, nicht vom Bestand abgezogen wird.
Nun speichern Sie bitte mit einem Klick auf Speichern die Einstellungen ab und klicken Sie anschließend auf Zahlarten synchronisieren und Express-Widgets synchronisieren (sofern Sie Änderungen an den Widget Einstellungen vorgenommen haben). Beachten Sie bitte die Reihenfolge!
Die anderen beiden Optionen und Buttons können Sie ignorieren und so belassen, wie sie sind - diese sind für andere (über die reine Zahlungsabwicklung hinausgehende) Usecases konzipiert und werden für die Nutzung unserer Zahlarten nicht benötigt.
Schritt 6: Zahlarten bearbeiten
Nachdem Sie alle Zahlarten synchronisiert haben, können Sie diese in den Optionen bearbeiten. Dazu öffnen Sie im Reiter Einstellungen die Option Zahlungsarten und klicken im sich nun öffnenden Fenster auf die gewünschte Zahlart.
Alle relevanten Einstellungen werden automatisch aktualisiert. Hier können Sie unter anderem einen Namen und eine Beschreibung für die Zahlart festlegen. Vergessen Sie nicht auf Speichern zu klicken, bevor Sie das Fenster schließen.
Bei einigen Zahlarten gibt es voreingestellte Limits, die ggf. nicht Ihren individuell mit dem PSP (Zahlungsanbieter) vereinbarten Limits entsprechen (insbesondere bei Rechnungskauf und Ratenzahlung ist meist ein Default-Limit (Standard) im Plugin voreingestellt, das aber für Sie ggf. nicht zutreffend sein könnte, fall Sie ein anderes Limit mit dem Anbieter ausgehandelt haben).
Sehen Sie daher bitte unter Riskmanagement > Zahlungsart bei den jeweiligen Zahlarten nach, ob der vorkonfigurierte Höchst- und Mindestbetrag dem entspricht, was Sie vereinbart hatten und ändern Sie ggf. die Beträge entsprechend Ihrer Vereinbarung mit dem Anbieter. Vergessen Sie danach nicht auf Speichern zu klicken.
Das Plug-in Testen: Der Sandbox-Modus
Möchten Sie das Plug-in zuerst testen? Bitte aktivieren Sie dazu den Sandbox-Modus (Sandbox = Ja) und tragen Sie in die Felder Business UUID, Client Secret und Client ID unsere Testdaten ein, die Sie hier finden. 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 Ihre Test-Transaktionen auch nicht in Ihrem payever Account sehen). Beachten Sie bitte, dass der Test-Account nur werktags von 8 bis 22 Uhr verfügbar ist - am Wochenende oder spät abends können Sie demnach keine Transaktionen im Sandbox-Modus vornehmen!
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 Plug-in 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 (Plug-in-Einstellungen, Namen und Texte der Zahlarten, etc.) beim Wechsel zwischen Live- und Sandbox-Modus (egal in welche Richtung) verloren gehen. Mit jedem Wechsel setzen Sie diese Einstellungen 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.
Achtung: Verwenden Sie die Zahlart "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 überweist. Der Kunde erhält zwar später nochmal eine separate E-Mail von 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:
Suchen Sie Ihre Rechnungsvorlage. Sofern Sie nichts anderes festgelegt haben, finden Sie diese per Default unter themes/Frontend/Bare/documents/index.tpl . Fügen Sie nun an der Stelle, an der Sie die Überweisungsdaten gerne hätten, folgenden Code ein:
{foreach from=$Order._order.attributes item=attribute name="payeverAttrLoop" key=attrKey}
{if $attrKey == 'payever_payment_details'}
{assign var="pe_details" value=$attribute|@json_decode:true}
{if $pe_details && $pe_details.usage_text}
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:
{if $Document.netto == false}
{$Order._amount|currency}
{else}
{$Order._amountNetto|currency}
{/if}
<br>
Verwendungszweck: {$pe_details.usage_text}<br>
{/if}
{break}
{/if}
{/foreach}
Nach der Integration: Hinweise zur Abwicklung von Zahlungen
Generell sind unsere Plug-ins 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 über den Status einer Zahlung zu informieren oder z.B. eine Zahlung zu stornieren!
Statusmeldungen - der Zahlungsstatus (nicht Bestellstatus) Offen 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 Accepted/Akzeptiert bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden. Der Status Überprüfung notwendig bedeutet, dass die Zahlung fehlgeschlagen ist, abgelehnt wurde oder durch Sie storniert (auch hier bitte keine Ware versenden). Der Zahlungsstatus Komplett Bezahlt steht für eine Transaktion, die bereits aktiviert/gecaptured wurde (d.h. der Betrag wurde beim Kunden abgebucht bzw. in Rechnung gestellt, und die Auszahlung an den Händler wurde beim Zahlungsanbieter angestoßen - bitte beachten Sie, dass das tatsächliche Buchungsdatum, an dem das Geld Ihrem Konto gutgeschrieben wird, abweichen kann, da es mitunter 1-2 Werktage dauern kann, bis der Geldeingang auf Ihrem Konto verbucht wird und Sie zudem ggf. auch mit dem entsprechenden Zahlungsanbieter statt einer sofortigen Auszahlung eine monatliche oder wöchentliche Sammelauszahlung vereinbart haben könnten).
Capture/ Warenversand - Bitte beachten Sie, dass Sie uns bei den meisten unserer Zahlungsarten über das Setzen eines bestimmten Status (siehe Schritt 5) den Warenversand bzw. die erfolgreiche Ausführung der Bestellung melden müssen, damit die zuvor genehmigte Zahlung ausgeführt bzw. aktiviert wird (Capture). Sollten Sie hingegen "Autocapture" (automatische Aktivierung bei Genehmigung) eingestellt haben, ist keine Rückmeldung an uns notwendig (selbiges gilt auch für die Zahlarten Direktüberweisung und Lastschrift - bei diesen Zahlarten wird immer automatisch sofort gebucht).
Beachten Sie bitte, dass es bei den meisten Zahlarten auch eine Aktivierungsfrist gibt (je nach Zahlart unterschiedlich, bitte lesen Sie mehr dazu in den Anleitungen der Zahlarten, die Sie nutzen, nach). Sollten Sie innerhalb dieser Frist keinen Versand/ keine Ausführung der Bestellung an uns übermitteln, verfällt die Genehmigung und die Zahlung kann somit nicht mehr ausgeführt werden.
Einige Zahlungsanbieter (Santander AT, Santander BE) verlangen zudem zusätzlich Nachweise über den Versand bzw. die Ausführung der Bestellung, welche dann i.d.R. direkt an den Zahlungsanbieter zu übermitteln sind (bei Santander Österreich bitte an teilzahlung@santanderconsumer.at) um die Auszahlung zu erhalten.
Stornierungen und Erstattungen - Bei einer vollständigen Erstattung reicht es, wenn Sie den Order Status/Bestellstatus auf "Storniert/Abgelehnt" setzen und speichern (dieser wird automatisch in payever übernommen). Wenn Sie eine Transaktion teilweise erstatten möchten, öffnen Sie bitte die Bestelldetails (Kunden > Bestellungen > bei der betroffenen Transaktion auf das Stift-Symbol klicken > payever tab). Für eine Stornierung wählen Sie Storno/Gutschrift, für eine Teilretoure bzw. einen Teilstorno wählen Sie bitte Teilerstattung und geben den zu erstattenden Betrag ein.
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 17 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!