Schritt 1: Account anlegen
Erstellen Sie sich hier, sofern Sie das noch nicht getan haben, Ihren kostenlosen payever Account.
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.
Falls Sie diese App zum ersten Mal nutzen: folgen Sie einfach den Anweisungen unseres Onboarding-Assistenten und wählen Sie die gewünschte Zahlart aus der Liste aus, indem Sie auf installieren klicken.
Falls Sie schon öfters hier waren: Sie finden die Zahlarten im Reiter Zahlarten am oberen Bildschirm-Rand). Klicken Sie auf + Hinzufügen und wählen Sie aus der nun erscheinenden Liste die gewünschte Zahlungsart aus und klicken auf installieren.
Nun öffnet sich eine Schaltfläche, deren Aufbau sich je nach Zahlungsart unterschiedlich gestaltet.
Bei den Zahlungsarten Kreditkarte, Lastschrift, Sofortüberweisung 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 Ratenkauf, Rechnungskauf, Direktüberweisung und Ratenkredit müssen Sie hier Ihre Zugangsdaten eingeben, die Sie von der Santander erhalten haben, und anschließend auf Verbinden klicken. (Sie waren noch nicht mit der Santander in Kontakt? Schreiben Sie bitte an ecommerce@santander.de, um Ihre Zugangsdaten zu erhalten. Hinweis: den Ratenkredit können Sie alternativ auch direkt hier beantragen, indem Sie die Bereiche Konto und Dokumente ausfüllen - für die anderen Zahlarten ist eine Kontaktaufnahme via Email erforderlich).
Unabhängig von der Zahlart, achten Sie bitte darauf, Ihre Zugangsdaten stets in den Reiter Standard einzutragen.
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 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.
Wählen Sie den Reiter API Schlüssel und klicken Sie auf + Hinzufügen. Geben Sie dem API Schlüssel einen beliebigen Namen und klicken Sie auf Erstellen. Klicken Sie nun auf das Plus-Symbol - 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 Schließen.
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).
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 Payment Providers geleitet. Scrollen Sie nach unten zu Alternative payment methods, klicken Sie auf Choose alternative payment und wählen Sie aus der Liste die entsprechende Zahlungsart aus.
In der nun erscheinenden Liste Alternative payment providers suchen Sie nach der gewünschten Zahlungsart.
Schneller geht es, wenn Sie in die Suchleiste oben den entsprechenden Namen eingeben:
- Ratenkredit: Santander Ratenkredit
- 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
Hier geben Sie nun die Client ID und das Client Secret ein, das Sie zuvor (siehe Abbildung 3.5) erstellt haben. Klicken Sie auf den lila Activate Button rechts unten. Die Checkbox Enable test mode 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 payment methods, mit dem Zusatz "is active":
Schritt 5: Private App erstellen und verknüpfen
Wählen Sie in Shopify Apps aus und klicken Sie auf Manage private apps.
Erstellen Sie nun eine neue private App, indem Sie auf Create a new private app klicken.
Geben Sie der App einen beliebigen Namen und geben Sie Ihre Email-Adresse ein. Klicken Sie auf Save. Nun werden die Daten API Key, Password, Example URL und Shared Secret automatisch generiert.
Bitte achten Sie unbedingt darauf, unter Admin API Permissions für den Bereich Orders, transactions and fulfillments die Option Read and Write einzustellen (siehe rechte Abbilung unten). Andernfalls werden Sie später Probleme bei der Übermittlung von Status-Updates zwischen Shopify und payever bekommen!
Zu guter letzt kopieren Sie bitte API Key, Password, Example URL und Shared Secret in Ihrem payever Account unter Checkout App > Kanäle > Shopify in die entsprechenden Felder ein, so wie es im obigen Screenshot 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 (zu finden unter Alternative Payment Providers > Name der Zahlungsart > Enable test mode), tragen Sie unter Account Information in die Felder Client Secret und Client ID unsere Testdaten ein, die Sie hier finden, und klicken Sie Activate bzw. Reactivate. 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.
Tipp: Um zu überprüfen, welche Zahlungseinstellung Sie in Shopify eingestellt haben, gehen Sie bitte zur Seite Settings > Payment Providers und scrollen Sie ganz nach unten zum letzen Punkt Payment Capture.
Die Markierung als versendet oder captured können Sie in den Bestelldetails durchführen (> Orders > betroffene Bestellung).
Stornierungen und Erstattungen
Wenn Sie eine Transaktion erstatten möchten, öffnen Sie dazu bitte die Bestelldetails (> Orders > betroffene Bestellung). Klicken Sie oben links auf Refund.
Nun geben Sie ein, welche und wie viele Produkte Sie erstatten möchten, und klicken auf den Refund Button rechts.
Bitte beachten Sie dabei aber, dass nicht alle unsere Zahlarten über eine automatische Stornierungsfunktion verfügen: Ratenkredite können Sie nur vor dem Warenversand über payever/Shopify 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.
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!