Shopware 6

Schritt 1: Account anlegen

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: 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 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.

Für die Zahlungsmethoden Kreditkarte, Lastschrift und PayPal genügt ein Klick auf die Schaltfläche Verbinden. Sie werden daraufhin zum entsprechenden Anbieter weitergeleitet. Dort haben Sie die Möglichkeit, entweder Ihren bereits bestehenden Account zu verknüpfen oder einen neuen Account zu erstellen.

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 Codes ist alles möglich) - Details dazu finden Sie in der Anleitung zur jeweiligen Zahlungsart.

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 UseCase mehrere Paare an Zugangsdaten für die gleiche Zahlungsart 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 Zahlungsarten verbunden haben, können Sie an der Zahlungsart 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 in der linken Navigationsleiste Kanäle aus.

Klicken Sie auf Hinzufügen. 

Bitte wählen Sie aus der nun erscheinenden Liste Shopware 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 + 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. 

Zuletzt klicken Sie auf den Reiter Downloads (oberhalb von API Schlüssel) und laden sich aus der nun aufklappenden Liste die neueste Version unseres Plugins herunter (Zip-File). (In der Regel oben stehend; falls Sie doch Probleme haben sollten, dann kontaktieren Sie uns gerne hier: support@payever.de).

Schritt 4: Plugin installieren

Loggen Sie sich in Ihren Shopware Account ein und holen Sie sich unser kostenloses Plugin. Sie können dies entweder über Ihren Shopware Marketplace Zugang erledigen (empfohlen) oder Sie downloaden sich das Plugin aus Ihrem payever Account und laden es manuell hoch (Upload Extension). Den Plugin-Bereich finden Sie unter Extensions > My Extensions.

Installieren Sie nun zunächst das Plugin, indem Sie auf Installieren klicken, um es dann anschließend aktivieren zu können (mit Klick auf den Kippschalter, sodass dieser blau wird).

Schritt 5: Verknüpfung mit payever herstellen

Nun klicken Sie im Dreipunkt-Menü auf Configure, um noch einige Einstellungen vorzunehmen:

• Enable Sandbox:  Bitte deaktivieren Sie den Sandbox Modus (es sei denn Sie möchten zunächst einige Testtransaktionen durchführen, in diesem Fall klicken Sie bitte auf "Set up Sandbox API keys" - 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).
• Iframe: Hier empfehlen wir die Aktivierung dieser Option. Wenn Sie das Iframe wählen, wird der payever Checkout in einem Bereich/Iframe innerhalb Ihrer Webseite geladen, der Kunde verlässt Ihren Shop nicht. Lassen Sie diesen Kippschalter deaktiviert, wird der Kunde hierfür auf ein neues Fenster mit einer payever URL weitergeleitet.
• Checkout Sprache: Hier wählen Sie entweder die Sprache Ihres Shops oder die Einstellung Default - diese bewirkt, dass payever automatisch die Sprache wählt, die im Browser dieses Kunden eingestellt ist. 

• 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 Zahlungsanbieter weitergeleitet, wenn Sie hingegen "Ja" wählen, wird der Kunde direkt ohne Umwege auf die Seite des Zahlungsanbieters weitergeleitet.

• Die Einstellungen unter Products & Inventory können Sie vollständig ignorieren, wenn Sie unser Plugin nur für die Zahlungen nutzen wollen (dafür werden diese Einstellungen nicht benötigt).

Nun speichern Sie bitte mit einem Klick auf Save die Einstellungen ab und klicken Sie anschließend auf Synchronisieren (beachten Sie bitte die Reihenfolge).

Weiter unten auf der Seite finden Sie die Einstellungen Express Widgets settings. Widgets sind interaktiv nutzbare Elemente, wie zum Beispiel ein Paybutton oder ein Ratenrechner (Für weitere Informationen klicken Sie bitte hier: Widgets & Ratenrechner). Wenn Sie kein Widget auf Ihrer Seite anzeigen lassen wollen sind diese Einstellungen für Sie irrelevant. Wenn Sie jedoch an der Verwendung eines Widgets interessiert sind können Sie hier durch Anklicken der Kippschalter einstellen, ob Sie das Widget auf der Produktseite (Enable FE Widget On Product Page) und/oder im Warenkorb (Enable Widget On Cart Page) anzeigen lassen möchten. Unter Theme Style können Sie auswählen, ob das Overlay unseres Checkouts in heller oder dunkler Variante angezeigt werden soll, indem Sie rechts im Feld mit einem Klick auf den Pfeil das Dropdown-Menü öffnen und light (hell) oder dark (dunkel) auswählen. Bei Express widget type müssen Sie auswählen, welches Widget Sie anzeigen lassen möchten. Nachdem Sie Ihre Einstellungen beendet haben klicken Sie bitte auf Synchronize express widgets.

Schritt 6: Zahlarten bearbeiten

Nachdem Sie alle Zahlarten synchronisiert haben, können Sie diese in den Einstellungen unter Settings > Shop > Payment bearbeiten. 

Hier sehen Sie auf einen Blick, welche Zahlarten Sie aktiviert haben und können Beschreibungen und Namen der Zahlarten mit Klick auf Edit details anpassen. 

Schritt 7: Zahlarten zum Sales Channel hinzufügen

Zu guter Letzt fügen Sie unter Storefront dem gewünschten Shop unter Payment and Shipping die Zahlarten hinzu, die Sie in diesem Shop verwenden möchten und klicken Sie danach auf Speichern/Save. Dieser Schritt ist zwingend erforderlich - wenn Sie diesen Schritt weglassen, werden Sie die Zahlungsarten anschließend aus Kundensicht nicht in Ihrem Checkout vorfinden. 

Das Plugin Testen - der Sandbox Modus

{% for transaction in order.transactions %} 
{% if transaction.customFields.payever_pan_id %} 
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.amountTotal|currency(currencyIsoCode) }} 
<br> 
Verwendungszweck: {{ transaction.customFields.payever_pan_id }}<br> 
{% endif %} 
{% endfor %}