Achtung: unsere Plugin kann nur xt:Commerce Pro Shops integriert werden. In der Free-Variante können Sie generell nur den Klaran-Checkout verwenden, andere Zahlungsanbieter werden grundsätzlich nicht unterstützt.
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 xt:Commerceaus 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 herunterladen
Loggen Sie sich in Ihren xt:Commerce Account ein und holen Sie sich unser kostenloses Plugin. Sie können dies entweder über Ihren xt:Commerce Plugin store erledigen (empfohlen) oder Sie downloaden sich das Plugin aus Ihrem payever Account und laden es manuell hoch.
Schritt 5: Plugin konfigurieren
Falls das Plugin noch nicht installiert ist, können Sie dies unter Plugins > deinstallierte Plugins vornehmen.
Öffnen Sie nun in den Einstellungen > Zahlungsweisen > payever und nehmen Sie einige Einstellungen vor (ggf. müssen Sie die Seite neu laden, damit das Plugin erscheint).
- Die Felder Verzeichnis, Icon, Steuerklasse, Template und Kostenhinweis anzeigen belassen Sie so, wie sie nach der Installation automatisch sind (kein Umkonfiguration nötig/sinnvoll).
- Bei Status setzen Sie ein Häkchen, um das Plugin zu aktivieren.
- Bei Reihenfolge können Sie festlegen, an welcher Stelle im Checkout die payever Zahlarten angezeigt werden sollen (verglichen mit anderen Zahlungsplugins).
- In die Felder Client Secret, Client ID und Client Secret geben Sie nun die Daten ein, die Sie in Schritt 3 in Ihrem payever Account generiert haben, im Feld Modus wählen Sie Live. (Es sei denn Sie möchten das Plugin zunächst testen, dann verfahren Sie wie hier beschrieben).
- Bei Standardsprache geben Sie ein, in welcher Sprache die Zahlarten angezeigt werden sollen. Bedient Ihr Shop mehrere Länder mit unterschiedlichen Sprachen, empfehlen wir die Einstellung Standard (erkennt automatisch die Sprache des Kunden).
- Bei Zahlungsnamen anzeigen (nur für xt:Commerce 5 version) können Sie bestimmen, ob für alle Ihre payever Zahlarten ein zusätzliches Feld mit der Anzeige "payever - Alle Zahlarten" in Ihrem Checkout angezeigt werden soll. Wir empfehlen Ihnen diese Einstellungen zu aktivieren wenn Sie mehr als eine Zahlart von uns verwenden.
- Icon der Zahlart sichtbar legt fest, ob ein der Zahlart entsprechendes Logo angezeigt werden soll.
- Beschreibung der Zahlart sichtbar legt fest, ob zu den Zahlarten ein Beschreibungstext eingeblendet werden soll.
- Bei Zahlungsraten anzeigen können Sie bestimmen, ob die Raten Ihrer Zahlarten (Beispiel 0.35% Fixgebühr) angezeigt werden sollen. Diese Anzeige is lediglich für die Kundenansicht, und hat keinen Einfluss auf die tatsächliche Einstellung der Kostenübernahme, die Sie separat für jeden Zahlart bearbeiten können.
- Die Einstellung Zu payever weiterleiten bestimmt, ob der payever Checkout innerhalb eines Iframes auf Ihrer Website angezeigt werden soll, oder ob der Kunde auf eine separate Seite von payever weitergeleitet werden soll. Wir empfehlen hier die Einstellung Nein, da es aus Nutzersicht etwas angenehmer ist, den Shop für die Zahlung nicht verlassen zu müssen.
- In die Felder Status für den Versand von Waren und Status für Abbruch der Transaktion tragen Sie bitte entsprechend Ihrer Prozesse und Gewohnheiten ein, auf welchen Status hin Sie den Warenversand an den Zahlungsdienstleister melden (und damit das Capture der Zahlung bewirken) möchten und auf welchen Status hin die Zahlung beim jeweiligen Anbieter entsprechend storniert werden soll.
Bevor Sie nun die Einstellungen synchronisieren, müssen Sie die Einstellungen Speichern und Übernehmen (Sie finden diesen button auf dem hellgrauen Balken). Nun synchronisieren Sie das Plugin mit Klick auf Bearbeiten > Einstellungen synchronisieren.
Schritt 6: Zahlarten konfigurieren
Bleiben Sie auf der selben Seite wie in Schritt 5 und scrollen Sie nach unten. Hier sehen Sie nun die Einstellungsmöglichkeiten für die einzelnen Zahlarten.
Hier können Sie u.a. Name und Beschreibungstext der Zahlart anpassen, die Zahlart aktiv oder inaktiv stellen sowie das Minimum und Maximum anpassen (ab welchem bis zu welchem Betrag soll die Zahlart im Checkout erscheinen - Achtung, geben Sie kein höheres Maximum oder niedrigeres Minimum als das ein, was Sie vertraglich mit dem jeweiligen Zahlungsanbieter vereinbart haben). Unter Gebühren übernehmen legen Sie fest, ob Sie die Zahlungsgebühren auf den Preis aufschlagen wollen (false) oder ob diese im Preis enthalten sein sollen (true). Direkt darunter legen Sie, falls Sie false gewählt haben, noch fest, wie viel Gebühr aufgeschlagen werden soll.
Schritt 7: Spracheinstellungen konfigurieren
In diesem Schritt haben Sie die Möglichkeit, den Titel und die Beschreibung aller im Checkout angezeigten Zahlungsmethoden nach Ihren Präferenzen anzupassen.
Das unten stehenden Beispiel betrifft die Zahlart Santander Rechnungskauf Deutschland:
- Um Titel und Beschreibung der Zahlungsmethode Santander Rechnung DE zu ändern, müssen Sie nach unten scrollen, bis Sie die Registerkarten [Rechnungskauf] Titel Übersetzungsschlüssel und [Rechnungskauf] Beschreibung Übersetzungsschlüssel sehen.
- Kopieren Sie zunächst den Schlüssel "XT_PAYEVER_TITLE_SANTANDER_INVOICE_DE".
- Gehen Sie dann zu Lokalisierung > Sprachinhalt und suchen Sie nach dem soeben kopierten Übersetzungsschlüssel und klicken Sie auf das Bearbeiten Zeichen rechts.
- Sie können nun den Titel (bzw. die Beschreibung) der gewählten Zahlungsarten bearbeiten. Es gibt zwei Reiter, einen für die deutsche Spracheinstellung und die andere für die englische Spracheinstellung, die Sie beide anpassen können. Bitte vergessen Sie nicht, auf speichern zu klicken.
Schritt 8: Das Plugin Testen: der Sandbox-Modus
Möchten Sie das Plugin 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 vis 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 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 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 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 Rechnungskauf und/oder 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.
In Ihrem Rechnungs-Template (oder sonstigem Template, das die $order_data Variable enthält), fügen Sie bitte an der gewünschten Stelle folgenden Code ein:
{if $order_data.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_total.total.formated} <br>
Verwendungszweck: {$order_data.pan_id}<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 xt:Commerce 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 In Process (payever) 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 (payever) bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden. Der Status Failed (payever) bedeutet, dass die Zahlung fehlgeschlagen ist, oder vom Zahlungsanbieter abgelehnt wurde (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. Dies müssen Sie allerdings nicht händisch erledigen, es reicht aus, wenn Sie den Status der betroffenen Bestellung nach dem Warenversand in xt:Commerce entsprechend umstellen. Auf welchen Status Sie umstellen müssen hängt dabei davon ab, was Sie in Schritt 5 bei Status für den Versand von Waren eingeben haben.
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.
Stornierungen und Erstattungen - Wenn Sie eine Transaktion erstatten/stornieren möchten, müssen Sie ebenfalls nur den Status in xt:Commerce anpassen, der Storno-Wunsch wird dann automatisch an uns und den betroffenen Zahlungsanbieter weitergeleitet. Auf welchen Status Sie umstellen müssen hängt dabei davon ab, was Sie in Schritt 5 bei Status für Abbruch der Transaktioneingeben haben.
Eine Teilerstattung (Kunde retourniert einen Teil der Bestellung) ist nur über Ihren payever Account möglich. Öffnen Sie dazu die Transactions App, öffnen Sie die Details der betroffenen Transaktion und gehen Sie oben rechts auf Erstattung. Sie können nun den zu stornierenden Betrag eingeben und die Stornierung abschließen.
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!