Plugin-ID: s360_santander
JTL-Shop 4.06 und dessen Systemvoraussetzungen
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.
Laden Sie die aktuelle Version des Plugins hoch.
Führen Sie in der Plugin-Verwaltung das Update des Plugins durch.
Hier werden Ihnen die Bestellungen, die über Santander gezahlt wurden, angezeigt.
Dieser Tab hat keine Bedeutung für die Konfiguration des Plugins.
Hier werden Ihnen die Bestellungen, die per Santander Direktüberweisung gezahlt wurde, angezeigt.
Dieser Tab hat keine Bedeutung für die Konfiguration des Plugins.
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.
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.
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.
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.
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:
Schaltet zwischen Sandbox- und Live-Modus um.
Geben Sie hier den Zahlungs-Channel an, den Sie von Heidelpay oder Santander erhalten haben.
Geben Sie hier die User-ID an, die Sie von Heidelpay oder Santander erhalten haben.
Geben Sie hier das Passwort ein, das Sie von Heidelpay oder Santander erhalten haben.
Geben Sie hier die Security-Sender-ID ein, die Sie von Heidelpay oder Santander erhalten haben.
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:
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! |
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 "ö").
Geben Sie hier die IBAN des Empfänger-Kontos an.
Geben Sie hier die BIC des Empfänger-Kontos an (optional).
Geben Sie hier die Straße des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.
Geben Sie hier die Postleitzahl des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.
Geben Sie hier die Stadt des Inhaber des Empfänger-Kontos an. Für Empfänger-Kontos in der Schweiz notwendig.
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.
Es wird eine Warnung angezeigt, falls der Benutzer ein Passwort/PIN mit 4 oder weniger Zeichen eingibt. Standardwert: "Ja"
Maximale Anzahl der Vorschläge der Autovervollständigung für das BIC/Banknamen Feld.
Gibt an, ob das Überweisungsformular beim Aufruf der Seite fokussiert werden soll. Standardwert: "Ja"
Gibt an, ob die Datenschutzerklärung in einem neuen Tab anstatt einem Popup/Modal-Fenster geöffnet werden soll. Standardwert: "Nein"
Es wird eine Warnung angezeigt, falls der Benutzer die Datenschutzerklärung nicht akzeptiert. Standardwert: "Ja"
Denken Sie daran, die Santander-Zahlungsarten auch mind. einer Versandart zuzuordnen - Sie finden diese Einstellungen unter Storefront → Kaufabwicklung → Versandarten.
Legen Sie in der Wawi die folgenden vier Auftragsattribute an (unter "Verkauf" > "Auftragsattribute"):
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.
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. |
Legen Sie eine Zahlungsart mit dem Namen "Ratenkauf von Santander" an.
Aktivieren Sie für diese Zahlungsart "Auslieferung vor Zahlungseingang möglich".
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") |
Im Plugin-Backend sehen Sie eine Bestellübersicht der mit Santander bezahlten Bestellungen.
Die Tabellenspalten haben folgende Bedeutung:
Die JTL-Shop-Bestellnummer.
Der Gesamtbetrag der Bestellung
Welche Zahlungsart genau genutzt wurde.
Der Zahlungsstatus.
Das Versanddatum der Bestellung.
Das Datum der Bestellung.
Das Stornodatum der Bestellung, falls storniert wurde.
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.
Im Plugin-Backend sehen Sie eine Bestellübersicht der mit Santander Direktüberweisung getätigten Bestellungen.
Die Tabellenspalten haben dabei folgende Bedeutung:
Die JTL-Shop-Bestellnummer
Der Gesamtbetrag der Bestellung
Von FintecSystems vergebene ID der Transaktion
Der verwendete Verwendungszweck der Überweisung
Der Modus der Transaktion. Folgende Modi sind möglich:
Das Versanddatum der Bestellung
Das Bezahldatum der Bestellung
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.
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.
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.
Wenn Sie eine Bestellung vor dem Versand in der Wawi stornieren, wird dies automatisch vom Plugin an Heidelpay/Santander gemeldet.
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.
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.
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.
→ Stellen Sie bitte sicher, dass folgende Bedingungen erfüllt sind:
→ 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.