Shopify

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

Klicken Sie im rechten oberen Eck auf Fertig.

 

Schritt 4: Zahlarten verknüpfen

Öffnen Sie nun erneut den Kanal Shopify. Jetzt sollten Sie folgendes Fenster sehen, in dem unter Accepted payments eine Liste mit allen zuvor von Ihnen aktivierten Zahlarten sowie der Option payever zu sehen ist.

Sie haben nun grundsätzlich zwei Möglichkeiten, die Zahlungsarten zu integrieren: 

• Klicken Sie neben payever auf integrate, integrieren Sie alle aktivierten Zahlarten auf einmal. Im Checkout sieht der Kunde dann nur eine Option "payever", und bekommt erst nach der Weiterleitung zu payever die unterschiedlichen Optionen zur Auswahl gestellt. 
• Klicken Sie neben einer der Zahlarten auf integrate, integrieren Sie nur diese Zahlart, welche dann im Shopify Checkout als einzelne Zahlart mit einem entsprechenden Namen und Logo aufgeführt wird. Möchte Sie mehrere Zahlarten auf diese Art und Weise integrieren, wiederholen Sie deb im folgenden beschriebenen Prozess einfach, bis Sie alle Zahlarten einzeln hinzugefügt haben. (Hinweis zur abweichender Namensgebung: Wire Transfer = Vorkasse, Santander Invoice = Rechnungskauf, Santander Factoring = Ratenkauf, Santander Installment = Ratenkredit, Stripe Credit Card = Kreditkarte, Stripe Direct Debit = Lastschrift; Paypal, Sofortüberweisung und Direktüberweisung heißen wie gewohnt. Achtung auch bei den Krediten: die deutsche Version heißt Ratenkredit und die österreichische Teilzahlung, die beiden werden in Shopify als separate Zahlarten dargestellt und je nach Adresse des Kunden wir die jeweils passende Variante angezeigt). 

I.d.R. entscheiden sich Händler bevorzugt für letztere Variante, damit im Checkout für den Kunden direkt ersichtlich ist, welche Zahlarten zur Verfügung stehen.

Mit Klick of Integrate werden Sie zu Shopify weitergeleitet, wo Sie sich mit Ihren gewohnten Daten einloggen.

Nun bestätigen Sie noch, dass Sie mit der Installation einverstanden sind.

Sie werden nun zur Seite Zahlungen weitergeleitet. Scrollen Sie nach unten zu Alternative Zahlungsmethoden, klicken Sie auf Alternative Zahlung auswählen und wählen Sie aus der Liste die entsprechende Zahlungsart aus.

In der nun erscheinenden Liste Alternative Zahlungsanbieter suchen Sie nach der gewünschten Zahlungsart.

Es gibt nun 2 Möglichkeiten.

• Wenn Sie bei der Integration der Zahlungsarten in Schritt 4 die payever Integration vorgenommen haben, so müssen Sie lediglich nach der alternativen Zahlungsanbieter payever suchen und diesen einen aktivieren.

• Wenn Sie bei der Integration der Zahlungsarten in Schritt 4 einzelne Zahlarten integriert haben, welche dann im Shopify Checkout als einzelne Zahlart mit einem entsprechenden Namen und Logo aufgeführt werden, so müssen Sie im nachfolgenden Schritt alle vorher ausgewählten Zahlungsmethoden einzeln aktivieren (Beispiel: Santander Rechnungskauf)

Schneller geht es, wenn Sie in die Suchleiste oben den entsprechenden Namen eingeben: 

• Ratenkredit Deutschland: Santander Ratenkredit
• Ratenkredit Österreich: Santander Teilzahlung
• Rechnungskauf: Santander Rechnungskauf powered by payever
• Ratenkauf: Santander Ratenkauf powered by payever
• Direktüberweisung: Direktüberweisung
• PayPal: Paypal (payever)
• Vorkasse: Cash - Wire Transfer
• Sofortüberweisung: SOFORT Banking

In beiden fällen müssen Sie nun die Client ID und das Client Secret eingeben, die Sie zuvor (siehe Abbildung 3.4) erstellt haben. Klicken Sie auf den grünen aktivieren Button rechts unten. Die Checkbox Testmodus aktivieren lassen Sie frei, es sei denn Sie möchten zunächst einige Test-Transaktionen abschließen (wenn ja, lesen Sie bitte hier weiter).

 

Wiederholen Sie diesen Vorgang (Schritt 4) mit allen Zahlungsarten, die Sie hinzufügen möchten. Wenn Sie fertig sind, sehen Sie die aktivierten Zahlarten alle unterhalb von Alternative Zahlungsmethoden, mit dem Zusatz "ist aktiv": 

Schritt 5: Private App erstellen und verknüpfen

Wählen Sie in Shopify Apps aus und klicken Sie auf Private Apps verwalten.

Erstellen Sie nun eine neue private App, indem Sie auf Neue private App erstellen klicken.

Geben Sie der App einen beliebigen Namen und geben Sie Ihre Email-Adresse ein.

Nun müssen Sie den Reiter Inaktive Admin-API-Berechtigungen anzeigen anklicken. Sie finden diesen Reiter wenn Sie weiter nach unten scrollen.

Es öffnet sich eine alphabetische Liste, die alle inaktiven API-Berechtgungen anzeigt. Bitte achten Sie unbedingt darauf, unter für den Bereich Bestellungen und Fulfillmentdienste die Option "Lesen und Schreiben" und bei Produkte auf "Lesezugriff" einzustellen (s. Abbilung unten). Andernfalls werden Sie später Probleme bei der Übermittlung von Status-Updates zwischen Shopify und payever bekommen! 

Klicken Sie zuletzt auf Speichern.

Nun werden die Daten API Key, Password, Example URL und Shared Secret automatisch generiert. Diese finden Sie wiederum oben beim Reiter Admin-API.

Zu guter letzt kopieren Sie bitte API Key, Password, Example URL und Shared Secret und fügen diese in Ihrem payever Account unter Checkout App > Kanäle > Shopify in die entsprechenden Felder ein, so wie es im nachfolgendem Bild gezeigt wird.

Das Feld Santander Capture Method steht per Default auf Payment Capture and/or Order Fulfillment - das bedeutet die Zahlung wird direkt nach der Autorisierung durch den jeweiligen Zahlungsanbieter auch gecaptured (Capture = Aktivierung der Zahlung)*. Bitte stellen Sie dies um auf Order Fulfillment**, wenn Sie wollen, dass das Capture erst dann erfolgt, wenn Sie die Bestellung als ausgeführt/fulfilled markieren. Wir empfehlen die Einstellung Order Fulfillment, denn damit stellen Sie sicher, dass zwischen Zahlung und Lieferung der Ware nicht allzu viel Zeit vergeht, was insbesondere bei längeren Lieferzeiten die kundenfreundlichere Vorgehensweise ist. Mehr Details dazu finden Sie hier.

Klicken Sie nun zum Abschluss auf "Connect".

*Aktivierung kann ja nach Zahlungsart etwas anderes bedeuten -  z.B. dass die Kreditkarte des Kunden belastet wird oder der Betrag vom Konto des Kunden abgebucht wird. Im Fall der Santander Zahlarten bedeutet "Capture", dass der Kunde die Rechnung bzw. den Ratenplan zugeschickt bekommt und Sie den Kaufbetrag erhalten.

**Hinweis: Wenn Sie "Order Fulfillment" eingestellt haben, achten Sie bitte darauf, versendete Bestellungen auch konsequent in Shopify entsprechend als ausgeführt/fulfilled zu markieren! Andernfalls wird Ihr Kunde nicht belastet (kein Geldeinzug oder Rechnungsversand) und Sie erhalten auch keine Auszahlung. 

 

Das Plugin Testen: der Test-Modus

Möchten Sie das Plugin zuerst testen? Bitte aktivieren Sie dazu den Test Mode. Dafür müssen Sie zunächst wieder in die Einstellungen und auf den Reiter Zahlungen.

 

Dort müssen Sie auf Alternative Zahlungsmethoden > Name der Zahlungsart > Testmodus aktivieren.  Tragen Sie unter Account Information in die Felder Client Secret und Client ID unsere Testdaten ein, die Sie hier finden, und klicken Sie auf reaktivieren. Um die Bezahlung im Testmodus bestätigt zu bekommen, nutzen Sie bitte die entsprechenden Stub-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 live gehen möchten, vergessen Sie bitte nicht, den Testmodus auszuschalten, die Testdaten zu entfernen und stattdessen Ihre eigenen Daten aus Ihrem payever Account einzutragen, und anschließend erneut Reactivate zu klicken. 

 

Nutzen Sie die Zahlungsart "Santander Rechnungskauf"?

Falls nein, sind Sie hiermit fertig, falls ja, befolgen Sie bitte auch noch die folgende Anleitung:

Santander versendet an Ihre Kunden keine Rechnung im herkömmlichen Sinne (PDF mit Bestellzusammenfassung, Aufführung der einzelnen Posten, etc.), sondern nur eine Email, in der der Kunde die Überweisungsdaten mitgeteilt bekommt sowie die Zahlungsfrist. Diese Email wird dann versendet, wenn Sie die Bestellung in Shopify als "ausgeführt/versendet" markieren. Wenn Sie von ihrem Shop aus eine Rechnung versenden (höchstwahrscheinlich tun Sie das), achten Sie bitte darauf, bei Bestellungen, die mittels Rechnungskauf bezahlt wurden, einen entsprechenden Verweis in Ihre Rechnung einzufügen. Auf diese Art und Weise teilen Sie Ihrem Kunden mit, dass er/sie vorerst noch nichts überweisen muss und auf entsprechende Emails von der Santander warten soll. Dies ist nötig, damit der Kunde das Geld nicht direkt an Sie überweist statt an die Santander. 

Wenn Sie Ihre Rechnungen über die Shopify-eigene Rechnungsfunktion erstellen, können Sie die entsprechende Bemerkung wie folgt Ihrer Rechnung hinzufügen: 

Gehen Sie zu Settings > Notifications > Order confirmation und suchen Sie nach der folgenden Code-Zeile: 

{{ transaction.gateway | replace: "_", " " | capitalize }}
 — <strong>{{ transaction.amount | money }}</strong>

Wenn Sie diese Zeile gefunden haben, kopieren Sie bitte direkt darunter folgenden Code ein: 

{% if transaction.gateway == "payever_gateway_name" %} 

<p>Sie haben bei dieser Bestellung {{ transaction.gateway | replace: "_", " " | capitalize }} als Zahlungsart ausgewählt. Sobald wir Ihre Bestellung versendet haben, erhalten Sie von der Santander eine separate Email mit den Überweisungsdaten. Bitte warten Sie mit der Bezahlung ab, bis Sie diese Email erhalten haben, und verwenden Sie bei Ihrer Überweisung den dort angegebenen Verwendungszweck. Ab Erhalt der Email mit den Überweisungsdaten haben Sie 30 Tage Zeit, um den Rechnungsbetrag zu überweisen.</p> 

{% endif %}

"payever_gateway_name" ist der Name, den Sie diesem Gateway in Shopify gegeben haben, geschrieben in Kleinbuchstaben und mit Unterstrichen statt Leerzeichen. Wenn Ihr Gateway also z.B.  "Santander Rechnungskauf powered by payever" heißt, müssten Sie hier folgendes eingeben: "santander_rechnungskauf_powered_by_payever" 

Sie nutzen nicht die Shopify-eigene Rechnungsfunktion, sondern ein Drittanbieter-Plugin? Bitte fragen Sie unseren Support (siehe Email-Adresse unten), wenn Sie nicht wissen ob und wie Sie dort eine Bemerkung zur Rechnung hinzufügen können.

Für Billbee, das am häufigsten genutze Rechnungs-Plugin, gehen Sie bitte wie folgt vor:

Die PAN-ID selbst kann leider nicht an Billbee übergeben werden (Billbee hat hierfür kein Feld)- es reicht allerdings aus, wenn Sie bei den betroffenen Zahlarten eine entsprechende Bemerkunghinzufügen, die auf die in Kürze per Email folgende Rechnung der Santander verweist.

Öffnen Sie dazu in Billbee die Layoutvorlagen und wählen Sie dort den Reiter Hinweistexte für Zahlarten. Unter Zahlart geben Sie den Namen ein, den Sie den Namen des betroffenen Payment Gateways eon, und unter Text geben Sie den Hinweistext* ein. 

*Textvorschlag Beispiel für Rechnungskauf: “Sie haben bei dieser Bestellung den Santander Rechnungskauf als Zahlungsart ausgewählt. Sobald wir Ihre Bestellung versendet haben, erhalten Sie von der Santander eine separate Email mit den Überweisungsdaten. Bitte warten Sie mit der Bezahlung ab, bis Sie diese Email erhalten haben, und verwenden Sie bei Ihrer Überweisung den dort angegebenen Verwendungszweck. Ab Erhalt der Email mit den Überweisungsdaten haben Sie 30 Tage Zeit, um den Rechnungsbetrag zu überweisen."

 

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

Die folgende Tabelle erklärt Ihnen, wie Statusmeldungen von payever Zahlungen in Shopify zu deuten sind. Wir empfehlen, diese sorgfältig zu lesen und ggf. auch mit weiteren Personen in Ihrem Unternehmen, die mit ihrem Shopify Shop bzw. in der Bestellabwicklung arbeiten, zu teilen. Mit payever Status sind die Statusmeldungen gemeint, die Sie in Ihrem payever Account sehen. 

payever Status	Shopify Status	Beschreibung
In Progress	Authorised	Diesen Status sehen Sie vor allem bei der Zahlungsart Ratenkredit (wenn der Kunde den Checkout abgeschlossen hat und von Santander angenommen wurde, aber noch eine Identifizierung oder Unterschrift leisten muss), ggf. auch bei anderen Zahlarten, wenn die Entscheidung über Annahme/Ablehnung des Zahlungsanbieters verspätet eintrifft. Bitte versenden Sie in keinem Fall Bestellungen, die in diesem Status sind! Warten Sie auf den Statuswechsel zu Paid.
Accepted	Paid	Die Zahlung wurde akzeptiert, Sie können die Ware versenden! (Beachten Sie bitte, dass Sie zunächst in Shopify auf capture klicken müssen um diesen Status zu bekommen falls Sie "manual capture" in Shopify eingestellt haben. Bie "automatic capture" wechselt der Status automatisch zu Paid, sobald eine Annahme vorliegt - beim Ratenkredit ist das mitunter auch erst einige Tage später, bei allen anderen Zahlarten üblicherweise sofort).
Refunded	Refunded	Sie haben Teile der Bestellung storniert/retourniert.
Cancelled/Declined	Voided	Sie haben eine Bestellung komplett storniert, oder der Kunde wurde vom Zahlungsanbieter abgelehnt (beachten Sie, dass sofort/automatisch abgelehnte Transaktionen i.d.R. gar keine Bestellung in Shopify erzeugen - dies passiert nur dann, wenn die Ablehnung nachträglich/einige Zeit nach Abschluss des Checkouts eintrifft).

 

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. Sie müssen dies nicht manuell in payever markieren, Ihre Zahlungen werden mit einer entsprechenden Statusänderung un Shopify automatisch bei uns und beim Zahlungsanbieter als gecaptured markiert. Wann genau dies passiert, hängt von Ihren Einstellungen in payever (Capture Method wie in Schritt 5 beschrieben) und Ihren allgemeinen Zahlungseinstellungen in Shopify (manual vs. automatic) ab. 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.

Tipp: Um zu überprüfen, welche Zahlungseinstellung Sie in Shopify eingestellt haben, gehen Sie bitte zur Seite Einstellungen > Zahlungen und scrollen Sie ganz nach unten zum letzen Punkt Zahlungserfassung. Dort können Sie einstellen, ob Sie 1. die Zahlungen automatisch autorisieren lassen 

oder 2. ob Sie die Zahlungen manuell erfassen.

Bestelldetails einsehen (Ausführen/Markieren/Capture)

Suchen Sie nun in der linken Navigationsleiste den Reiter Bestellungen und wählen dort Ihre betroffene Bestellung aus. 

Im nächsten Schritt können Sie 1. Ihre Bestelldetails einsehen, 2. Die Bestellung als ausgeführt markieren und 3. sofern Sie im obigen Schritt die 2. Option (manuell erfassen) gewählt haben, die Zahlung erfassen.

 

 

 

Stornierungen und Erstattungen 

Wenn Sie eine Transaktion erstatten möchten, öffnen Sie dazu bitte die Bestelldetails der gewünschten Bestellung (Bestellungen > betroffene Bestellung). Suchen Sie in der oberen Navigationsleiste den Reiter Zurückerstatten. 

Sie können hier entscheiden, welche und wie viele Produkte Sie erstatten möchten und klicken auf den grünen Button unten rechts, um den ausgewählten Betrag erstatten zu lassen. 

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!