Übersicht

Plugin-ID: s360_santander

Installation

Systemvoraussetzungen

JTL-Shop 4.06 und dessen Systemvoraussetzungen

Installationsvorgang

Die Installation erfolgt im Standardvorgehen wie für alle JTL-Shop Plugins.

Laden Sie das Plugin in den Shop hoch.

Aktivieren Sie das Plugin über die Plugin-Verwaltung.

Updatevorgang

Laden Sie die aktuelle Version des Plugins hoch.

Führen Sie in der Plugin-Verwaltung das Update des Plugins durch.

Konfiguration

JTL-Shop

Plugin-Einstellungen

Tab "Bestellungen"

Hier werden Ihnen die Bestellungen, die über Santander gezahlt wurden, angezeigt.

Dieser Tab hat keine Bedeutung für die Konfiguration des Plugins.

Tab "Direktüberweisungen"

Hier werden Ihnen die Bestellungen, die per Santander Direktüberweisung gezahlt wurde, angezeigt.

Dieser Tab hat keine Bedeutung für die Konfiguration des Plugins.

Tab "Einstellungen"

Secret (optional)

Geben Sie hier irgendein für Ihren Shop einzigartiges geheimes Passwort vor. Dies erhöht die Sicherheit in der Server-zu-Server-Kommunikation zwischen Ihrem Shop und dem Heidelpay-Gateway.

Wenn Sie hier nichts eingeben, generiert das Plugin auf Basis der Shop-URL einen Code.

Error Mail (optional)

Geben Sie hier die E-Mail-Adresse ein, an die Fehlermeldungen (üblicherweise bei technischen Problemen im Bestellungsabgleich) gesendet werden sollen. Wenn Sie dieses Feld leer lassen, werden diese E-Mails an Ihre Master-E-Mail-Adresse gesendet.

Tab "Experten-Einstellungen"

Direktüberweisung: Zahlungseingang automatisch setzen

Gibt an, ob das Plugin den Zahlungseingang nach der Finalisierung der Transaktion seitens FintecSystems automatisch setzen soll. Wenn Sie hier "Nein" einstellen, müssen Sie die Zahlungen auf anderem Weg (z.B. per HBCI oder manuell) in der WaWi setzen.

PhpQuery-Einstellungen (Template-Einhängepunkte)

Das Plugin gibt an verschiedenen Orten im Template eigene Teile aus (z.B. auf der Zahlungsartauswahl, auf der Bestellbestätigungsseite und auf der Bestellabschlussseite).

Hier können Sie einstellen, wo und wie diese Snippets ins HTML eingebunden werden sollen.

Die Default-Werte beziehen sich auf das EVO-Template.

Zahlungsart-Einstellungen

Die "üblichen" Zahlungsarteinstellungen und Zugangsdaten konfigurieren Sie in den Zahlungsarteinstellungen von JTL-Shop. Diese finden Sie im Adminbereich unter Storefront → Zahlungsarten → Übersicht.

Hier können Sie die Direktüberweisung, den Ratenkauf und den Rechnungskauf separat konfigurieren.

Die folgenden Einstellungen sind spezifisch für Santander:

Raten- und Rechnungskauf

Sandbox Modus

Schaltet zwischen Sandbox- und Live-Modus um.

Channel (Channel-ID)

Geben Sie hier den Zahlungs-Channel an, den Sie von Heidelpay oder Santander erhalten haben. 

User ID (ggf. auch "Login")

Geben Sie hier die User-ID an, die Sie von Heidelpay oder Santander erhalten haben.

Password (ggf. auch "Kennwort)

Geben Sie hier das Passwort ein, das Sie von Heidelpay oder Santander erhalten haben.

Security Sender (ggf. auch "Sender-ID")

Geben Sie hier die Security-Sender-ID ein, die Sie von Heidelpay oder Santander erhalten haben.

Direktüberweisung

API Key / API Schlüssel

Geben Sie hier den API Key (API Schlüssel) an, den Sie von FintecSystems oder Santander erhalten haben. Ihren FintecSystems API Schlüssel können Sie hier finden: 

https://manage.xs2a.com/configure/apikeys


Bitte beachten Sie die verschiedenen Modi für die API Schlüssel. Mit einem API Schlüssel im Modus Test kann nicht auf Live Transaktionen zugegriffen werden. Umgekehrt kann ein Live API Schlüssel nicht auf Transaktionen im Test Modus zugreifen!


Empfänger

Geben Sie hier den Namen des Inhabers des Empfänger-Kontos an. Banken haben unterschiedliche Regeln bezüglich des Empfänger Namens, es wird daher empfohlen nur alphanumerische Zeichen (d.h. a-z, A-Z, 0-9) zu verwenden. Ungültige Zeichen werden entweder durch Leerzeichen ersetzt oder entsprechend umgewandelt (z.B. "oe" statt "ö").

IBAN

Geben Sie hier die IBAN des Empfänger-Kontos an.

BIC

Geben Sie hier die BIC des Empfänger-Kontos an (optional).

Straße

Geben Sie hier die Straße des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.

Postleitzahl

Geben Sie hier die Postleitzahl des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.

Stadt

Geben Sie hier die Stadt des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.

Ländercode

Geben Sie hier den Ländercode (AT, CH, DE, etc.) des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.

Formular: Anmeldeinformationen validieren

Es wird eine Warnung angezeigt, falls der Benutzer ein Passwort/PIN mit 4 oder weniger Zeichen eingibt. Standardwert: "Ja"

Formular: Vorschläge für Autovervollständigung

Maximale Anzahl der Vorschläge der Autovervollständigung für das BIC/Banknamen Feld.

Formular: Formular fokussieren

Gibt an, ob das Überweisungsformular beim Aufruf der Seite fokussiert werden soll. Standardwert: "Ja"

Formular: Datenschutzerklärung in neuem Tab öffnen

Gibt an, ob die Datenschutzerklärung in einem neuen Tab anstatt einem Popup/Modal-Fenster geöffnet werden soll. Standardwert: "Nein"

Formular: Datenschutzerklärung validieren

Es wird eine Warnung angezeigt, falls der Benutzer die Datenschutzerklärung nicht akzeptiert. Standardwert: "Ja"

Versandarten

Denken Sie daran, die Santander-Zahlungsarten auch mind. einer Versandart zuzuordnen - Sie finden diese Einstellungen unter Storefront → Kaufabwicklung → Versandarten.

JTL-Wawi

Auftragsattribute anlegen

Legen Sie in der Wawi die folgenden vier Auftragsattribute an (unter "Verkauf" > "Auftragsattribute"):

Zahlungsarten konfigurieren

Wichtig: Die Zahlungsartnamen müssen genau so, wie hier beschrieben sein und mit dem Namen im Shop übereinstimmen, sonst schlägt ggf. die Zuordnung zur Zahlungsart innerhalb der Wawi fehl.

Rechnungskauf von Santander

Legen Sie eine Zahlungsart mit dem Namen "Rechnungskauf von Santander" an.

Aktivieren Sie für diese Zahlungsart "Auslieferung vor Zahlungseingang möglich".

Im Reiter Rechnungsdruck fügen Sie bitte unbedingt folgenden Inhalt ein:

Bitte überweisen Sie den Gesamtbetrag auf folgendes Bankkonto:

Empfänger: {{ Vorgang.Attribute | Replace: '^.*santander_empfaenger=(.*?)(\||$).*','$1' }}
IBAN: {{ Vorgang.Attribute | Replace: '^.*santander_iban=(.*?)(\||$).*','$1' }}
BIC: {{ Vorgang.Attribute | Replace: '^.*santander_bic=(.*?)(\||$).*','$1' }}
Verwendungszweck: {{ Vorgang.Attribute | Replace: '^.*santander_verwendungszweck=(.*?)(\||$).*','$1' }}


Sowohl der Name der Zahlungsarten als auch der Inhalt für den Rechnungsdruck müssen für jede genutzte Sprache hinterlegt werden!


Dieser Schritt ist wichtig. Nur so ist sichergestellt, dass die Kunden die Überweisung an das richtige Konto tätigen.

Ratenkauf von Santander

Legen Sie eine Zahlungsart mit dem Namen "Ratenkauf von Santander" an.

Aktivieren Sie für diese Zahlungsart "Auslieferung vor Zahlungseingang möglich".

Direktüberweisung von Santander

Legen Sie eine Zahlungsart mit dem Namen "Direktüberweisung von Santander" an.

Legen Sie eine Zahlungsart mit dem Namen "Direct Transfer by Santander" an, falls Ihr Shop Englisch unterstützt.


Der JTL-Shop setzt als Zahlungsartnamen immer den jeweiligen Anzeigenamen der Zahlungsart. Die JTL-Wawi erkennt die Zahlungsart nur anhand des Namens!

Wenn Sie den Namen im Shop ändern, müssen Sie entsprechend auch in der Wawi die Zahlungsart umbenennen. Da es sich um den angezeigten Namen handelt, welcher offensichtlich sprachabhängig ist, müssen Sie diesen Schritt auch für alle Sprachen beachten.

Bitte prüfen Sie bei einer Testbestellung, ob die Wawi die Zahlungsart in den Auftragsdetails korrekt selbst erkannt hat.


Hier beispielhaft ein Screenshot aus der JTL-Wawi (Bereich "Zahlungsarten anlegen")


Betrieb

JTL-Shop

Bestellübersicht

Im Plugin-Backend sehen Sie eine Bestellübersicht der mit Santander bezahlten Bestellungen.

Die Tabellenspalten haben folgende Bedeutung:

Bestellnr.

Die JTL-Shop-Bestellnummer.

Betrag

Der Gesamtbetrag der Bestellung

Zahlart

Welche Zahlungsart genau genutzt wurde.

Zahlstatus

Der Zahlungsstatus.

Versendet am

Das Versanddatum der Bestellung.

Vorgemerkt

Das Datum der Bestellung.

Storniert

Das Stornodatum der Bestellung, falls storniert wurde.

Finalisiert

Wann die Bestellung gegen Santander finalisiert wurde. Dies geschieht beim Versand der Bestellung. Solange die Bestellung nicht finalisiert wurde, steht hier, wie lange die Bestellung bereits auf den Versand wartet.

Direktüberweisungen

Im Plugin-Backend sehen Sie eine Bestellübersicht der mit Santander Direktüberweisung getätigten Bestellungen.

Die Tabellenspalten haben dabei folgende Bedeutung:

Bestellnr.

Die JTL-Shop-Bestellnummer

Betrag

Der Gesamtbetrag der Bestellung

Transaktion

Von FintecSystems vergebene ID der Transaktion

Verwendungszweck

Der verwendete Verwendungszweck der Überweisung

Modus

Der Modus der Transaktion. Folgende Modi sind möglich:

Versendet am

Das Versanddatum der Bestellung

Bezahlt am

Das Bezahldatum der Bestellung

JTL-Wawi

Rechnungs- und Ratenkauf

Bearbeitung von Bestellungen

Die Bestellungen kommen vom Plugin als "unbezahlt" in der Wawi an.
Erst, wenn Sie diese versenden, finalisiert das Plugin die Bestellung gegen Santander woraufhin Ihnen dann auch direkt ein Zahlungseingang angezeigt wird.

Zuordnung zu Überweisungen von Santander

Die Bestellungen mit Santander haben alle ein Bestell-/Auftragsattribut "santander_verwendungszweck". Dies ist die PAN (Transaktionsnummer) unter der auch Santander die entsprechende Auszahlung auf Ihr Konto vornimmt.

Auftrag ändern

Aufgrund der Abgleichdynamik zwischen Shop und Wawi unterstützt das Plugin keine Änderung der Aufträge.
Stornieren Sie im Zweifelsfall den Auftrag und legen Sie einen neuen Auftrag mit einer anderen Zahlungsart an oder lassen Sie den Kunden erneut im Shop bestellen.

Storno

Wenn Sie eine Bestellung vor dem Versand in der Wawi stornieren, wird dies automatisch vom Plugin an Heidelpay/Santander gemeldet.

Gutschriften

Das Plugin unterstützt keine automatischen Gutschriften und bietet im Backend auch keine Funktionalität dafür an.
Gutschriften müssen Sie daher über das Heidelpay-Backend durchführen.

Sonderfälle

Heidelpay-Backend

Zur Prüfung und ggf. manueller Bearbeitung einzelner über Rechnungs- oder Ratenkauf getätigter Bestellungen können Sie sich auch jederzeit in Ihr Heidelpay-Backend einloggen und dort die Transaktionen verwalten.

Bedenken Sie jedoch, dass das Plugin dann nichts über diese Transaktionen "weiß" und ggf. abweichende Informationen anzeigt.

FintecSystems-Backend

Zur Prüfung und ggf. manueller Bearbeitung einzelner über Santander Direktüberweisung getätigter Bestellungen können Sie sich auch jederzeit in Ihr FintecSystems-Backend einloggen und dort die Transaktionen verwalten.

Bedenken Sie jedoch, dass das Plugin dann nichts über diese Transaktionen "weiß" und ggf. abweichende Informationen anzeigt.

FAQ

Ich habe alles eingerichtet, sehe aber die Zahlungsarten nicht. Was kann die Ursache sein?

→ Stellen Sie bitte sicher, dass folgende Bedingungen erfüllt sind:

Kann ich die Santander Zahlungsarten innerhalb der PayPal Paymentwall darstellen?

→ Das ist NICHT möglich. Innerhalb der Santander Zahlungsarten befinden sich wichtige Felder (Angabe Geburtsdatum etc.), welche die Paymentwall von PayPal nicht ausgibt. Hier muss im PayPal Plugin konfiguriert werden, dass Drittanbieter-Zahlungsarten unterhalb der Paymentwall angezeigt werden sollen.

Changelog

v1.08 (in Betatestphase)

v1.07

v1.06

v1.05 (nicht releaste Zwischenversion)

v1.04

v1.03 (Closed Beta / RC1)

v1.02 (Closed Beta)

v1.01 (Closed Beta)

v1.00 (Closed Beta)