JTL 4

Sie nutzen bereits JTL 5? Bitte wechseln Sie zu dieser Anleitung.

 

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 JTL aus und klicken 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. 

Sie können unser Plugin direkt im JTL Extensionsstore hier herunterladen (Bitte beachten Sie, dass es für JTL 4 und JTL5 jeweils unterschiedliche Plugins gibt). 

 

Schritt 4: Plugin installieren

Loggen Sie sich in Ihren JTL Account ein und wählen Sie im Reiter Plugins die Pluginverwaltung aus.

Dort wählen Sie wiederum den Reiter Upload aus und klicken auf Auswählen. Laden Sie nun mit Klick auf Hochladen die Zip-Datei hoch, die Sie zuvor aus Ihrem payever Account heruntergeladen und auf Ihrem Rechner gespeichert hatten. 

Wenn der Upload erfolgreich war, sollten Sie die folgende Erfolgsmeldung sehen: 

Wechseln Sie jetzt zum Reiter Verfügbar. Dort sollten Sie das soeben hochgeladene Plugin nun sehen können. Setzen Sie ein Häkchen links neben das Plugin und klicken Sie auf den Button Installieren.

Schritt 5: Plugin konfigurieren

Nach der Installation finden Sie das Plugin im Reiter Aktiviert. Klicken Sie auf das Zahnrad-Symbol unter Aktionen, um die Einstellungen zu öffnen. 

Hier müssen Sie nun einige Einstellungen treffen: 

• Modus: Wählen Sie bitte Live Modus aus (es sei denn Sie möchten zunächst einige Test-Transaktionen durchführen, in diesem Fall wählen Sie bitte den Sandbox Modus aus - 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, dann lassen Sie hier die vorausgefüllten Test-Daten stehen).
• Standardsprache Checkout: 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 dieses Kunden eingestellt ist. 
• Zeige Gebühr für die Zahlart: Sofern Sie Gebühren für eine Zahlungsarten verlangen, werden die Gebühren dem Kunden im Checkout angezeigt, wenn Sie Ja wählen. Ob Sie oder der Kunde die Gebühren tragen, können Sie bei einigen Zahlarten in Ihrem payever Account (Checkout App > Zahlarten) festlegen (bei den Zahlarten der Santander ist das nicht möglich, hier müssen Sie die Gebühren immer selbst tragen).
• Logo oder Name für die Zahlungsart anzeigen: Hier können Sie wählen, ob Sie lieber den Namen der Zahlungsart (z.B. "PayPal") oder das Logo des Zahlungsanbieters anzeigen wollen (entweder oder, beides zusammen geht nicht). 
• Zahlungsbeschreibung anzeigen: Sie haben in den Einstellungen der Zahlungsarten die Möglichkeit, für jede Zahlungsart eine kurze Beschreibung einzugeben, die dem Kunden im Checkout angezeigt wird. Hier können Sie pauschal festlegen, ob diese Texte angezeigt werden sollen oder nicht. 
• Redirect oder 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, 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.
• Die Kategorie "Produkte und Inventar" können Sie unverändert lassen, da Sie keine Auswrkungen haben. 
• Aktiviert: Wählen Sie hier bitte Ja. 
• Protokollierebene: Hier empfehlen wir die Einstellung Kritische Nachrichten. 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 Alle Nachrichten zu aktivieren, damit wir die Problemursachen besser analysieren können. 

Die Sektion mit APM Options können Sie so lassen, wie es anfänglich eingestellt war, verändern Sie hier nichts.

Wenn Sie fertig sind, vergessen Sie bitte nicht auf Speichern zu klicken.

Synchronisieren Sie anschließend im Reiter Synchronisierung und Dienstprogramme die Zahlungsarten. Klicken Sie dafür auf Synchronisieren.   

(Hinweis: Wenn Sie später einzelne Einstellungen, z.B. Zahlungsbeschreibung anzeigen, ändern wollen, reicht es aus die Änderung abzuspeichern, Sie müssen nicht synchronisieren. Synchronisieren müssen Sie nur, wenn Sie a) das Plugin in dieser Version zum ersten Mal aktivieren oder b) vom Sandbox in den Live Modus wechseln oder umgekehrt. Bitte beachten Sie, das beim Synchronisieren die Einstellungen, die Sie im folgenden Schritt 6 treffen, wieder mit den Default-Angaben überschrieben werden: d.h. wenn Sie z.B. zuerst im Sandbox Modus waren und dann einige Einstellungen an den Zahlarten vorgenommen haben, müssen Sie, nachdem Sie in den Live Modus gewechselt und synchronisiert haben, diese Einstellungen erneut vornehmen.) 

Schritt 6: Zahlungsarten anpassen

Überprüfen Sie nach der Synchronisierung, ob alle Zahlarten aktiviert sind, die auch in Ihrem payever Konto aktiviert sind und die Sie Ihren Kunden anbieten wollen. Klicken Sie dafür auf Storefront in der oberen Navigationsleiste und unter Zahlungsarten auf Übersicht.  

Sie befinden sich nun in den Zahlungsarten-Einstellungen, wo Sie alle Ihre Zahlarten einsehen und bearbeiten können. 

Suchen Sie in der Liste nach den gewünschten Zahlarten. Diese sollten mit einem grünen Häkchen gekennzeichnet sein (sind Sie das nicht, überprüfen Sie bitte ob vielleicht das Plugin inaktiv geschaltet oder die Zahlart in Ihrem payever Account deaktiviert ist). Über einen Klick auf das Symbol rechts außen können Sie die Einstellungen dieser Zahlart bearbeiten.

Hinweis zur Namensgebung: Sie erkennen unsere Zahlarten an dem payever.de am Ende der Bezeichnung. Außerdem gilt: Santander Factoring DE = Ratenkauf, Santander Installment = Ratenkredit, Santander Invoice DE = Rechnungskauf, Stripe = Kreditkarte, Stripe Directdebit = Lastschrift, Instant Payment = Direktüberweisung, Cash = Vorkasse, Sofort = Sofortüberweisung)

Je nach Zahlungsart sind die verfügbaren Aktionen leicht unterschiedlich. Hier ein Beispiel: 

Hier können Sie unter anderem die Beschreibungstexte für diese Zahlungsart festlegen. 

Beachten Sie bitte, dass die Option Akzeptieren Gebühr (Händler versus Kunde trägt Gebühr) hier wirkungslos ist, da Sie von den Einstellungen in Ihrem payever-Account überschrieben wird. Wenn Sie also z.B. möchten, dass der Kunde die Gebühr trägt, reicht es nicht aus, hier Nein einzutragen, Sie müssen dies auch in Ihrem payever Account festlegen.

Mindestbestellwert und maximaler Bestellwert gilt es zu beachten, dass die Zahlungsanbieter selbst einen Rahmen vorgeben, in dem Sie sich bewegen müssen. (Beispiel: der Santander Rechnungskauf ist mit 5€ bis 750€ festgelegt - geben Sie hier z.B. 900€ ein, wird Ihren Kunden der Rechnungskauf trotzdem nur bei Warenkörben bis zu 750€ angezeigt). 

Bei Variable Gebühr und Fixe Gebühr bestimmen Sie lediglich, welche Gebühr dem Kunden bei der Auswahl der Zahlungsarten in einer schwarz hinterlegten Info-Box angezeigt werden soll, nicht aber welche Gebühren der Kunde tatsächlich zahlt. 

 

Schritt 7: Versandarten verknüpfen

Stellen Sie als nächstes sicher, dass die Zahlarten mit den relevanten Versandarten verknüpft sind. Klicken Sie dafür auf Storefront in der oberen Navigationsleiste und unter Kaufabwicklung auf Versandarten.

Hier sehen Sie nun Ihre unterschiedlichen Versandarten. Unter Zahlungsarten sehen Sie, welche Zahlungsarten derzeit für diese Versandart freigeschalten sind - ist die von Ihnen gewünschte Zahlart nicht dabei, klicken Sie auf Bearbeiten. 

Auf der sich nun öffnenden Seite mit dem Titel Versandart ändern scrollen Sie so lange nach unten, bis Sie beim Abschnitt Akzeptierte Zahlungsarten angekommen sind. Setzen Sie nun ein Häkchen neben die gewünschten Zahlungsarten und vergessen Sie nicht, anschließend am unteren Ende der Seite den Button Versandart ändern zu klicken. 

Ob es funktioniert hat können Sie feststellen in dem Sie überprüfen, ob die gewählten Zahlungsarten nun für diese Versandart unter Zahlungsarten aufgeführt ist. Diesen Prozess wiederholen Sie nun bei allen Versandarten, für die Sie die Zahlungsart anbieten möchten. 

 

ggf. Schritt 8: Verwenden Sie den PayPal Plus Checkout

Wenn Sie das vorgefertigte Checkout-Modul JTL PayPal verwenden, müssen Sie die gewünschten Zahlarten auch zum PayPal Checkout hinzufügen, damit diese dem Kunden angezeigt werden. Fügen Sie dazu einfach unter Plugins > JTL PayPal die gewünschten Zahlarten hinzu. Beachten Sie, dass dieses spezielle Checkout-Modul von PayPal maximal 5 zusätzliche Zahlarten von anderen Anbietern zulässt.

Das Plugin Testen: der Sandbox Modus

Möchten Sie das Plugin zuerst testen? Bitte aktivieren Sie dazu in den Plugin-Einstellungen den Sandbox Modus (siehe Schritt 5) und tragen Sie in die Felder Business UUID, Client Secret und Client ID unsere Testdaten ein. Sie können diese Daten händisch einkopieren oder einfach im Reiter Synchronisierung und Dienstprogramme den Button Sandbox API Schlüssel eintragen betätigen. 

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 diese Test Transaktionen auch nicht in Ihrem payever Account sehen). 

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 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 Synchronisierungs-Vorgang setzen Sie diese Einstellungen automatisch 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 (der Ratenkredit ist hiervon nicht betroffen), 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. Daher befolgen Sie bitte die folgenden Anweisungen: 

Da es keinen Möglichkeit gibt, eine Variable in die default Smarty engine einzufügen, haben wir hierfür eine eigene Syntax erarbeitet (# ist ein reserviertes Symbol):

#if_payeverPanId# 

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: {$Bestellung->WarensummeLocalized[0]} 
<br> 
Verwendungszweck: #payeverPanId#<br> 

#endif#

Ein Beispiel für Rechnungskauf-Templates in JTL Wawi finden Sie hier. 

Beachten Sie in Abhängigkeit Ihrer JTL Wawi Version folgendes: 

1. RegExMatch$ (Report.InvoiceNote, 'PAN: (.*)') - for JTL Wawi >= 1.4

2. RegExMatch$ (Vorgang.Auftrag.Hinweis.Text, 'PAN: (.*)') - for JTL Wawi <= 1.3.x

Video Zusammenfassung

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 JTL Backend oder aus JTL Wawi 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 in Bearbeitung 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 Bezahlt bedeutet, dass die Zahlung erfolgreich war und vollständig ist - in diesem Fall können Sie die Ware versenden. Der Status Storno bedeutet, dass die Zahlung fehlgeschlagen ist, abgelehnt wurde oder durch Sie storniert (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 automatischesCapture 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 JTL auf Versandt setzen. 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.

Dies können Sie unter Plugins > payever Payments mit Klick auf Waren versendet tun (ggf. müssen Sie zunächst auf Funktionen synchronisieren klicken, um die verfügbaren Optionen für diese Transaktion sehen zu können): 

Alternativ können Sie dies auch in JTL Wawi unter Verkauf mit Klick auf Ausliefern > OK erreichen.

Stornierungen und Erstattungen - Wenn Sie eine Transaktion erstatten möchten, können Sie dies ebenfalls unter Plugins > payever Payments tun, in dem Sie bei der betroffenen Bestellung auf Stornieren klicken. 

Alternativ können Sie dies auch in JTL Wawi unter Verkauf mit Klick auf Storno erreichen.

Teilstornierungen sind über JTlL oder JTL Wawi nicht möglich, diese tätigen Sie bitte über Ihren payever Account (> Transactions App > betroffene Transaktion anklicken > Erstattung).

Wählen Sie dort Teilbetrag stornieren und geben Sie dort den zu erstattenden Teilbetrag 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 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!