Unzer Zahlungsarten (JTL-Shop 5)
- 1 Einleitung
- 1.1 Features
- 2 Installation / Update
- 2.1 Systemvoraussetzungen
- 2.2 Weitere Voraussetzungen
- 2.2.1 Apple Pay
- 2.2.2 Google Pay
- 2.3 Plugin-Installation
- 2.4 Plugin-Update
- 3 Konfiguration
- 3.1 Shop
- 3.1.1 Zahlungsarten-Konfiguration
- 3.1.1.1 Unzer Ratenkauf
- 3.1.1.2 Google Pay
- 3.1.1.3 Versandarten zuweisen
- 3.1.2 Plugin Konfiguration
- 3.1.1 Zahlungsarten-Konfiguration
- 3.2 Apple Pay (veraltet)
- 3.2.1 Merchant Identifier
- 3.2.2 Merchant Domain
- 3.2.3 Merchant Identity Zertifikat
- 3.2.4 Payment Processing Zertifikat
- 3.3 JTL-Wawi
- 3.3.1 Zahlungsarten einrichten
- 3.3.2 Rechnungsdruckvorlage editieren
- 3.3.3 Auftragsattribute anlegen
- 3.3.4 Workflow anlegen
- 3.3.4.1 Workflow Bedingungen
- 3.3.4.2 Workflow Aktionen
- 3.1 Shop
- 4 Betrieb
- 4.1 Begriffsklärung / Glossar
- 4.2 Shop
- 4.3 ERP-System
- 4.3.1 Standardablauf
- 4.3.1.1 Rechnung
- 4.3.2 Stornos
- 4.3.3 Retouren
- 4.3.1 Standardablauf
- 5 Individualisierung
- 5.1 Templates
- 6 Troubleshooting
- 6.1 Logs prüfen
- 6.1.1 Browser-Log
- 6.1.2 Shop-Log
- 6.1.3 Webserver-Log
- 6.1 Logs prüfen
- 7 FAQ
- 8 Changelog
- 8.1 1.7.0 (November 2024)
- 8.2 1.6.4 (November 2024)
- 8.3 1.6.3 (September 2024)
- 8.4 1.6.2 (September 2024)
- 8.5 1.6.1 (August 2024)
- 8.6 1.6.0 (Juli 2024)
- 8.7 1.5.3 (Juli 2024)
- 8.8 1.5.2 (Juni 2024)
- 8.9 1.5.1 (Juni 2024)
- 8.10 1.5.0 (Mai 2024)
- 8.11 1.4.1 (April 2024)
- 8.12 1.4.0 (April 2024)
- 8.13 v1.3.2 (Januar 2024)
- 8.14 v1.3.1 (Januar 2024)
- 8.15 v1.3.0 (August 2023)
- 8.16 v1.2.1 (Februar 2023)
- 8.17 v1.2.0 (November 2022)
- 8.18 v1.1.0 (Juli 2022)
- 8.19 v1.0.2 (März 2022)
- 8.20 v1.0.1 (November 2021)
- 8.21 v1.0.0 (Juli 2021)
- 8.22 v0.9.8 (Juli 2021)
- 8.23 v0.9.7 (Juni 2021)
- 8.24 v0.9.6 (Mai 2021)
- 8.25 v0.9.5 (April 2021)
- 8.26 v0.9.4 (April 2021)
- 8.27 v0.9.3 (März 2021)
- 8.28 v0.9.2 (März 2021)
- 8.29 v0.9.1 (Februar 2021)
- 8.30 v0.9.0 (November 2020)
- 9 Support und Kontakt
Einleitung
Dieses Plugin integriert die folgenden Unzer-Zahlungsarten im JTL Shop:
Alipay
ApplePay
Bancontact
Direktüberweisung
EPS
Giropay
Google Pay
iDEAL
Kreditkarte
Lastschrift
SEPA Lastschrift
PayPal
Przelewy24
Ratenkauf
Rechnungskauf
SOFORT
TWINT
Vorkasse
WeChat Pay
(Veraltet) Unzer Ratenkauf
(Veraltet) Unzer Rechnungskauf
(Veraltet) Unzer Rechnungskauf (secured)
(Veraltet) Lastschrift (secured)
Features
viele Zahlungsarten in einem Plugin
Installation / Update
Systemvoraussetzungen
JTL-Shop 5.0.0+ und dessen Vorraussetzungen
PHP 7.4 bis PHP 8.3
Die folgenden PHP Erweiterungen
ext-json
ext-curl
Um Rundungsfehler bei der Übertragung von Fließkommazahlen an die API zu vermeiden, empfehlen wir Ihnen, den folgenden Wert in Ihrer php.ini
zu setzen, der einen verbesserten Algorithmus zur Rundung solcher Zahlen auswählt.
// php.ini
; When floats & doubles are serialized store serialize_precision significant
; digits after the floating point. The default value ensures that when floats
; are decoded with unserialize, the data will remain the same.
serialize_precision = -1
Alternativ kann dieser auch in der config.JTL-Shop.ini.php
gesetzt werden
ini_set('serialize_precision', -1);
Der Standardwert für serialize_precision
ist ab PHP 7.1.0 schon -1
daher bedarf es in den meisten Fällen keine weitere Anpassung.
Weitere Voraussetzungen
Sie müssen bei Unzer registriert sein.
Apple Pay
Wenn Sie Apple Pay auf Ihrer Seite anbieten möchten, müssen Sie außerdem die folgenden Voraussetzungen erfüllen:
Apple Developer Account mit Teilnahme am Apple Developer Program, siehe Mitgliedschaft auswählen - Support - Apple Developer
Ohne Teilnahme am am Apple Developer Program kann Apple Pay im Plugin nicht genutzt werden! Der einfache und kostenlose Apple Developer Account reicht nicht aus!
Google Pay
Wenn Sie Google Pay auf Ihrer Seite anbieten möchten, müssen Sie außerdem die folgenden Voraussetzungen erfüllen:
einhalten der https://payments.developers.google.com/terms/aup
einhalten der https://payments.developers.google.com/terms/sellertos
Google Pay Web Integration Checklist https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist
Einhalten der Google Pay Web Brand Richtlinien: https://developers.google.com/pay/api/web/guides/brand-guidelines
Händlershop bei Google Pay in der Unternehmenskonsole (Business Console) registrieren: https://pay.google.com/business/console/home/BCR2DN4TZK6PRCKS
Ohne Registrierung des Shops bei Google Pay kann Google Pay im Plugin nicht genutzt werden!
Plugin-Installation
Die Installation des Plugins erfolgt im Standardverfahren für JTL-Shop 5, wie es hier beschrieben ist.
Plugin-Update
Für ein Update laden Sie das Plugin wie bei einer Installation in der neuesten Version hoch (und überschreiben ggf. alle vorhandenen Plugindateien) oder folgen Sie den Hinweisen des Extension Stores.
Gehen Sie dann in die Pluginverwaltung und betätigen Sie den Update-Button.
Konfiguration
Shop
Zahlungsarten-Konfiguration
Die Konfiguration der einzelnen Zahlungsarten erfolgt über die Standard-Verwaltung im JTL-Shop Sie finden die Zahlungsarten unter Administration→ Zahlungen→ Zahlungsarten.
Unzer Ratenkauf
Option | Bedeutung |
---|---|
Effektiver Zinssatz (in %) | Gibt den effektiven Zinssatz der monatlichen Ratenzahlungen an. Der Wert ist an Ihre Händlerkonfiguration gebunden. Beispiel: 5.99 |
Google Pay
Option | Bedeutung |
---|---|
Buchungsmodus | Erfassen (Capture) = Betrag wird direkt erfasst/eingezogen Autorisierung (Authorize) = Betrag wird erst bei Versand der Bestellung erfasst/ |
| Von Unzer bereitgestellte Kanal-ID. Wird automatisch vom Plugin gesetzt und aktualisiert |
Händler ID | Wird von Google im Feld "Händlerinformationen" bereitgestellt. |
Händler Name | Wird von Google im Feld "Händlerinformationen" bereitgestellt. |
Kreditkarten zulassen | Kreditkartenzahlung über Google Pay zulassen oder nicht |
Prepaidkarten zulassen | Prepaidkartenzahlung über Google Pay zulassen oder nicht |
Mastercard akzeptieren | Mastercard als Zahlungsart in Google Pay akzeptieren (Kreditkarten müssen zugelassen sein) |
VISA akzeptieren | VISA als Zahlungsart in Google Pay akzeptieren (Kreditkarten müssen zugelassen sein) |
Discover akzeptieren | Discover als Zahlungsart in Google Pay akzeptieren (Kreditkarten müssen zugelassen sein) |
JCB akzeptieren | JCB als Zahlungsart in Google Pay akzeptieren (Kreditkarten müssen zugelassen sein) |
Button Farbe | Die Farbe des Google Pay Buttons: Standard (=aktuell Schwarz, kann aber jederzeit von Google geändert werden), Schwarz, Weiß Google empfiehlt den schwarzen Button zu nutzen, wenn der Shop einen weißen/hellen Hintergrund hat und den weißen Button, falls der Shop einen schwarzen/dunklen Hintergrund hat |
Button Größe | "Fest" = Feste Breite + Höhe des Buttons (Standard); "Ausfüllen" = Button versucht den verfügbaren Platz auszufüllen |
Versandarten zuweisen
Weisen Sie die Zahlungsarten den gewünschten Versandarten/Ländern unter Administration→ Versand→ Versandarten zu. Beachten Sie, dass nicht jede vom Plugin angebotene Zahlungsart in jedem Land zur Verfügung steht.
Plugin Konfiguration
Das Plugin-Backend erreichen Sie über Plugins → Installierte Plugins → Solution 360 Unzer. Gehen Sie im Plugin-Backend auf den Reiter “Einstellungen”, um die allgemeine Konfiguration einzusehen oder zu ändern.
Option | Bedeutung |
---|---|
Privater Schlüssel (Private Key) | Geben Sie hier den privaten API Schlüssel ein, den Sie von Unzer erhalten haben. |
Öffentlicher Schlüssel (Public Key) | Geben Sie hier den öffentlichen API Schlüssel ein, den Sie von Unzer erhalten haben. |
Händler ID für das Insight Portal | Geben Sie hier Ihre Händler ID für das Insight Portal an. Diese wird benötigt, um die Bestellungen im Plugin-Backend zum Insight Portal zu verlinken. Sie können Ihre Händler ID finden, wenn Sie das Insight Portal aufrufen und in der URL nachsehen: https://insights.unzer.com/merchant/{Händler-ID}/dashboard |
Schriftgröße | Schriftgröße für das Kreditkarten-Formular |
Schriftfarbe | Schriftfarbe für das Kreditkarten-Formular |
Schriftart | Schriftart für das Kreditkarten-Formular |
Zahlungseingänge automatisch setzen | Steuert, ob das Plugin automatisch Zahlungseingänge für die JTL-Wawi setzt. |
Selektor für den Submit-Button im Zahlungszwischenschritt | Der Selektor für den Submit-Button im Zahlungszwischenschritt. |
PQ-Selector für "Zahlungsart ändern" Button im Zwischenschritt | Der PHP-Query-Selektor für das Einhängen des "Zahlungsart ändern"-Buttons auf der Zahlungszwischenschritt-Seite. |
PQ-Einfügemethode für "Zahlungsart ändern" Button im Zwischenschritt | Die PHP-Query-Einfügemethode für das Einhängen des "Zahlungsart ändern"-Buttons auf der Zahlungszwischenschritt-Seite. |
PQ-Selector für Fehlermeldungen | Der PHP-Query-Selektor für das Einhängen von Plugin-Fehlermeldungen auf der Versandart/Zahlungsart-Auswahl etc. |
PQ-Einfügemethode für Fehlermeldungen | Die PHP-Query-Einfügemethode für das Einhängen von Plugin-Fehlermeldungen auf der Versandart/Zahlungsart-Auswahl. |
PQ-Selector für Zahlungsart-Extras auf der "Bestellung überprüfen"-Seite | Der PHP-Query-Selektor für das Einhängen von Zahlungsart-Extras auf der "Bestellung überprüfen"-Seite. |
PQ-Einfügemethode für "Bestellung überprüfen"-Seite | Die PHP-Query-Einfügemethode für das Einhängen von Zahlungsart-Extras auf der "Bestellung überprüfen"-Seite. |
Webhooks neu registrieren | Mit diesem Button können die Webhooks URLs neu registriert werden. Dies ist zum Beispiel notwendig, falls sich Ihre Shop-Url geändert hat. |
Apple Pay (veraltet)
Um Apple Pay nutzen zu können, müssen einige Einstellungen im Plugin und im Apple Developer Account vorgenommen, welche im folgenden näher erläutert werden.
Um mehr zu erfahren, Sie Apple Pay Dokumentation.
Merchant Identifier
Eine Händlerkennung (Merchant Identifier) weist Sie gegenüber Apple Pay eindeutig als Händler aus, der Zahlungen akzeptieren kann. Dazu muss diese zuerst im Apple Developer Account erstellt werden.
Klicken Sie unter “Certificates, Identifiers & Profiles” in der Seitenleiste auf “Identifiers” und dann oben links auf die Schaltfläche “Hinzufügen”
Schritt 1: Merchant Identifier erstellenWählen Sie dann in der Liste “Merchant IDs” aus und klicken dann auf weiter (“continue”)
Vergeben Sie eine Beschreibung für den Shop und die Kennung (Identifier)
Schritt 3: Beschreibung und Händler-KennungÜberprüfen Sie die Einstellungen und klicken dann auf Registrieren (Register)
Die so erstellte Händlerkennung (Merchant Identifier) kann nun im Shop Plugin hinterlegt werden
Merchant Domain
Die Händler/Shop-Url (Merchant Domain) ist die Url des Shops welcher die Apple Pay Transkationen verarbeitet. Dieser muss zuerst im Apple Developer Account hinterlegt werden.
Klicken Sie unter “Certificates, Identifiers & Profiles” in der Seitenleiste auf “Identifiers” und wählen dann Händler-IDs (Merchant IDs) aus dem Pop-up-Menü oben rechts aus. Danach können Sie die zuvor erstelle Händler-Kennung auswählen.
Unter Händler-Domains (Merchant Domains) klicken Sie auf “Domain hinzufügen” (“Add Domain”)
Geben Sie den vollständigen Domain-Namen an und klicken dann auf speichern
Klicken Sie auf Herunterladen (Download), legen Sie die heruntergeladene Datei an dem angegebenen Ort auf dem Server ab (z.B. per FTP) und klicken Sie dann auf Überprüfen (Verify)
Wenn Apple die Domain erfolgreich überprüfen konnte, klicken sie auf Erledigt (Done)
Die so erstellte Händler/Shop-Url (Merchant Domain) kann nun im Shop Plugin hinterlegt werden
Merchant Identity Zertifikat
Das Merchant Identity Zertifikat wird von Apple Pay genutzt um Sie als Händler zu identifizieren, welcher Apple Pay anbieten darf. Dieses muss aber zunächst erstellt und im Apple Developer Account und Shop Plugin hinterlegt werden.
Erstellen Sie eine Zertifikatsanforderungsdatei (Certificate Signing Request (CSR)) indem Sie in Shop Plugin im Bereich Merchant Identity Zertifikat auf den Button “Erneuern” klicken. (Im Feld daneben sollte nun der Inhalt des erstellen CSR angezeigt werden)
Laden Sie nun die CSR Datei herunter
Im Apple Developer Account: Klicken Sie unter “Certificates, Identifiers & Profiles” in der Seitenleiste auf “Identifiers” und wählen dann Händler-IDs (Merchant IDs) aus dem Pop-up-Menü oben rechts aus. Danach können Sie die zuvor erstelle Händler-Kennung auswählen.
Klicken Sie unter Apple Pay Händler-Identitätszertifikat (Apple Pay Merchant Identity Certificate) auf Zertifikat erstellen (Create Certificate)
Klicken Sie auf Datei auswählen (Choose File) und wählen Sie die in Schritt 2 heruntergeladene Datei aus.
Klicken Sie auf Fortfahren (Continue)
Klicken Sie auf herunterladen (Download)
Laden Sie nun die heruntergeladene Datei im Shop Plugin im Bereich Merchant Identity Zertifikat unter dem Punk Apple Pay Zertifikat hoch. Speichern Sie danach die Einstellungen!
Payment Processing Zertifikat
Ein Zahlungsverarbeitungszertifikat (Payment Processing Zertifikat) ist mit Ihrer Händlerkennung (Merchant Identity) verknüpft und wird zur Verschlüsselung von Zahlungsdaten verwendet. Das Zahlungsabwicklungszertifikat läuft alle 25 Monate ab. Wenn das Zertifikat widerrufen wird, können Sie es neu erstellen.
Erstellen Sie eine Zertifikatsanforderungsdatei (Certificate Signing Request (CSR)) indem Sie in Shop Plugin im Bereich Merchant Identity Zertifikat auf den Button “Erneuern” klicken. (Im Feld daneben sollte nun der Inhalt des erstellen CSR angezeigt werden)
Laden Sie nun die CSR Datei herunter
Im Apple Developer Account: Klicken Sie unter “Certificates, Identifiers & Profiles” in der Seitenleiste auf “Identifiers” und wählen dann Händler-IDs (Merchant IDs) aus dem Pop-up-Menü oben rechts aus. Danach können Sie die zuvor erstelle Händler-Kennung auswählen.
Klicken Sie unter Apple Pay-Zahlungsverarbeitungszertifikat (Apple Pay Payment Processing Certificate) auf Zertifikat erstellen (Create Certificate)
Klicken Sie auf Datei auswählen (Choose File) und wählen Sie die in Schritt 2 heruntergeladene Datei aus.
Klicken Sie auf Fortfahren (Continue)
Klicken Sie auf herunterladen (Download)
Laden Sie nun die heruntergeladene Datei im Shop Plugin im Bereich Payment Processing Zertifikat unter dem Punk Apple Pay Zertifikat hoch. Speichern Sie danach die Einstellungen!
Mit dem Upload des Apple Pay Zertifikat werden auch die von Unzer benötigten Schlüssel an das Unzer System übertragen, sodass Unzer die Zahlungsdaten von Apple Pay auch entschlüsseln kann. Die entsprechenden “Unzer Payment Processing Zertifikat IDs” sollte dann in den entsprechenden Feldern angezeigt werden.
JTL-Wawi
Zahlungsarten einrichten
Öffnen Sie die Zahlungsartenverwaltung über Zahlungen → Zahlungsarten.
Legen Sie die Zahlungsarten, die Sie nutzen, mit folgenden Namen an:
Applepay
Alipay
Unzer Direktüberweisung
EPS
Giropay
Google Pay
iDEAL
Kreditkarte
Lastschrift
Unzer Lastschrift
PayPal
Przelewy24
Unzer Ratenkauf
Unzer Rechnung
SOFORT
Unzer Vorkasse
WeChat Pay
Markieren Sie bei den folgenden Zahlungsarten “Auslieferung vor Zahlungseingang möglich”:
Unzer Rechnung
Dies ist notwendig, weil die Aktivierung der Zahlung bei diesen Zahlungsarten erst beim Versand erfolgt.
Rechnungsdruckvorlage editieren
Fügen Sie bei Rechnungen folgenden DotLiquid Code für die Rechnungsdruckvolage ein.
Ihre Daten für die Überweisung:
Empfänger: {{ Vorgang.Attribute | Replace: '^.*unzer_account_holder=(.*?)(\||$).*','$1' }}
IBAN: {{ Vorgang.Attribute | Replace: '^.*unzer_iban=(.*?)(\||$).*','$1' }}
BIC: {{ Vorgang.Attribute | Replace: '^.*unzer_bic=(.*?)(\||$).*','$1' }}
Betrag: {{ Vorgang.Gesamtbetrag | Nummer: 'N2','de-de' }} {{Vorgang.Währung}}
Verwendungszweck: {{ Vorgang.Attribute | Replace: '^.*unzer_transaction_descriptor=(.*?)(\||$).*','$1' }}
Bitte beachten: Geben Sie bitte nur den Verwendungszweck an, andernfalls können wir Ihre Zahlung nicht zuordnen.
Die Rechnung ist bei Erhalt und ohne Abzug fällig. Bitte überweisen Sie den Gesamtbetrag schuldbefreiend auf das oben genannte Konto.
Sollten Sie bereits die Vorlagen 2.0 der Wawi im Einsatz haben, so fügen Sie folgenden Inhalt in Ihre Rechnungsvorlage ein:
Auftragsattribute anlegen
Das Plugin schreibt in die folgenden Attribute wichtige Informationen (sofern vorhanden) zu Transkationen:
unzer_iban
Die IBAN des Unzer Kontos, an welches der Kunde sein Geld überweisen muss.
unzer_bic
Die BIC des Unzer Kontos, an welches der Kunde sein Geld überweisen muss.
unzer_transaction_descriptor
Der Verwendungszweck von Unzer, den der Kunde auf Überweisungen angeben muss.
unzer_account_holder
Der Kontoinhaber des Unzer Kontos
unzer_short_id
Technische ID der Transaktion von Unzer, welche im Insight Portal genutzt werden kann, um die Transaktion zu finden
unzer_payment_id
Zahlungs ID von Unzer
unzer_payment_type_id
ID der Bezahlmethode
unzer_rate_pdf_link
Link zur PDF mit den Informationen zum Ratenplan für den Kunden.
unzer_rate_total_amount
Gesamtbetrag der Ratenzahlung
unzer_rate_total_purchase_amount
Bestellbetrag der Ratenzahlung
unzer_rate_total_interest_amount
Zinsbetrag der Ratenzahlung
unzer_card_number
Kartennummer (teilanonymisiert)
unzer_card_expiry_date
Ablaufdatum der Kreditkarte
unzer_card_cvc
CVC (anonymisiert)
unzer_card_type
Typ der Verwendeten Kreditkarte (z.B. MASTER, oder VISA)
Legen Sie diese Attribute unter Verkauf → Auftragsattribute an, damit Sie sie auch an Aufträgen einsehen können. In neueren WaWi Versionen kann die Auftragsattributverwaltung geöffnet werden, wenn man eine Bestellung öffnet. Dort können über den Button “Attribute …” → Attribute definieren → “Anlegen …” neue Attribute angelegt werden
Workflow anlegen
Die Zahlungsarten (Veraltet) Unzer Rechnung und (Veraltet) Unzer Ratenkauf benötigen die Rechnungsnummer, um die Bestellung beim Versand zu finalisieren. Die JTL-Wawi übermittelt die Rechnungsnummer allerdings nicht im Onlineshop-Abgleich. Daher wird mittels eines Workflows die Rechnungsnummer bei der Erstellung der Rechnung an das Plugin übermittelt.
Öffnen Sie die Workflowverwaltung unter Admin → JTL-Workflows. Legen Sie einen neuen Workflow für das auslösende Ereignis “Rechnungen Erstellt” an.
Workflow Bedingungen
Der Workflow muss die folgenden Bedingungen haben:
Option | Vergleich | Wert |
---|---|---|
gleich | Unzer Rechnung | |
gleich | Unzer Ratenkauf |
Workflow Aktionen
Legen Sie eine neue “Web-Request (POST)” Aktion für den Workflow mit den folgenden Optionen an:
Option | Wert |
---|---|
Url |
|
Parameter |
|
Betrieb
Dieser Bereich beschreibt den Umgang mit dem Plugin im Alltag.
Begriffsklärung / Glossar
Shop
Im Plugin-Backend können Sie im Reiter “Übersicht” die Bestellungen einsehen, die mit Unzer bezahlt wurden, sowie deren Status aus Sicht des Plugins.
Die Übersicht ist lediglich rein informativ - um manuell in Unzer Zahlungen einzugreifen, nutzen Sie bitte das Insight Portal.
ERP-System
Standardablauf
Das Plugin setzt den Zahlungseingang für die JTL-Wawi, sobald es von Unzer die Rückmeldung erhält, dass die Bestellung bezahlt worden ist. Mit Unzer bezahlte Bestellungen sollten also nur versendet werden, sofern diese im Status bezahlt sind.
Rechnung
Die Zahlungsart Rechnung ist hier die Ausnahme, da die Zahlung erst beim Versand finalisiert wird. Diese Bestellungen müssen Sie also versenden, bevor der Zahlungseingang in der JTL-Wawi gesetzt ist.
Stornos
Stornos von Bestellungen vor dem Versand werden vom Plugin automatisch erkannt und gegen Unzer weitergeleitet.
Retouren
JTL-Shop (und damit auch das Plugin) ist technisch nicht in der Lage, Retouren automatisch zu behandeln, da diese Information nicht im Shop ankommt.
Bei Retouren müssen Sie den Kunden das Geld daher auf anderem Weg zurückzahlen.
Individualisierung
Bestimmte Teile des Plugins lassen sich individualisieren.
Beachten Sie, dass Sie individualisierende Dateien bei Plugin-Updates ggf. vom JTL-Shop überschrieben werden könnten. Machen Sie sicherheitshalber vorher Backups angepasster Dateien und kopieren Sie sie nach dem Update zurück ins Plugin.
Templates
Das Template der Ratenplanzusammenfassung auf der Bestellübersichtsseite lässt sich ersetzen, indem Sie die Datei in frontend/templates/hire_purchase_direct_debit_custom.tpl
anlegen. Diese ersetzt dann die im Plugin vorhandene Datei.
Troubleshooting
Sollten Sie Probleme mit dem Plugin beobachten, prüfen Sie zunächst die Logs und wenden Sie sich ggf. an unseren Support oder Ihren Service-Partner, wenn Sie das Problem nicht selbständig lösen können.
Je mehr Informationen Sie dem Support bei einem Problem geben können, desto eher sind wir in der Lage, Ihnen zu helfen. Nicht reproduzierbare Probleme sind dagegen auch nur schwer zu analysieren.
Logs prüfen
Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 Logs dafür mehr oder weniger relevant.
Browser-Log
Das Browser-Log ist meist relevant, wenn irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)
Das Browser-Log sehen Sie, wenn Sie im Browser F12 drücken und dort dann auf Konsole (oder Console) wechseln.
Shop-Log
Das Shop-Log ist immer dann interessant, wenn im Frontend unerwartete Fehlermeldungen ausgegeben werden oder das Plugin zwar auf Eingaben im Frontend reagiert, aber nicht das Ergebnis liefert, was erwartet wurde. Manchmal ergibt sich auch durch das Browser-Log, dass die Informationen eher im Shop-Log zu suchen sind.
Das Shop-Log finden Sie im JTL-Adminbereich unter Administration→ Fehlerbehebung → Logbuch.
Webserver-Log
Das Webserver-Log wird dann relevant, wenn Sie irgendwo auf einen Error 500 (= weiße Seite) stoßen.
Das Webserver-Log kann Ihnen Ihr Hoster zur Verfügung stellen.
FAQ
Warum werden keine Rechnungen finalisiert?
Dies ist meistens der Fall wenn der Workflow zum übertragen der Rechnungsnummer nicht bzw. nicht richtig angelegt wurde. Sollten sich die folgenden Nachrichten im Shop-Log wiederfinden, so ist der Parameter der Workflow Aktion nicht korrekt angelegt wurden
Hinweis-Log
[Unzer] Called SyncWorkflowController with the following data: Array ( attrs: {{ Vorgang.Auftrag.Attribute }} invoice_id: {{ Vorgang.Rechnungsnummer }} invoice_date: {{ Datum.Gestartet }} )
Fehler-Log
[Unzer] Plugins360_unzer_shop4ControllersSyncWorkflowController: Missing parameter payment_id or invoice_id Array ( {{Vorgang_Auftrag_Attribute}}: )
Warum erhalte ich die Nachricht, dass sich die URL des Webhook oder des Workflows geändert hat?
Durch ein Update des Plugins kann es, aufgrund eines Fehlers im JTL Shop, vorkommen, dass die URLs der eigenen Seiten des Plugins (Unzer WaWi Workflow-Verarbeitung und Unzer Webhook-Verarbeitung) geändert haben. Dies hat zur Folge, dass diese Seiten im Shop nicht mehr erreichbar sind. Dadurch ist die korrekte Funktionsweise des Plugins nicht mehr gegeben.
Um diesen Fehler zu beheben, müssen im Adminbereich unter “Eigene Inhalte” > “Seiten” in der Linkgruppe “hidden” die Seiten Unzer WaWi Workflow-Verarbeitung und Unzer Webhook-Verarbeitung wie folgt geändert werden.
Der “Name für Suchmaschinen” der Standardsprache muss zuerst mit einer “-1” gespeichert werden (also unzer-sync-workflow-1
bzw. unzer-webhook-1
). Danach muss der "Name für Suchmaschinen" der Standardsprache wieder ohne eine “-1” gespeichert werden (also unzer-sync-workflow
bzw. unzer-webhook
).
Wenn diese Schritte korrekt ausgeführt wurden, sollte die Nachricht im Adminbereich des Plugins verschwunden sein und das Plugin wieder richtig funktionieren!
Changelog
1.7.0 (November 2024)
Added: Apple Pay v2 Integration
Changed: Alte Apple Pay Integration mit eigenem Apple Developer Account als veraltet markiert
1.6.4 (November 2024)
Added: Unterstützung für JTL 5.4
1.6.3 (September 2024)
fehlende Eingabevalidierung für Karteninhaber in der Kreditkarten-UI-Komponente hinzugefügt
Problem behoben, wenn JTL Zahlungsmethoden aufruft obwohl das Plugin deaktiviert ist
1.6.2 (September 2024)
Nicht mehr benötigtes “Bank”-Feld bei EPS entfernt
1.6.1 (August 2024)
Added: Feld für Karteninhaber bei Kreditkarten hinzugefügt, um neuen Anforderungen zu entsprechen https://docs.unzer.com/news/articles/visa-mandatory-field-updates-2024/
Added: Adressdaten im Customer Object hinzugefügt
1.6.0 (Juli 2024)
neue Zahlungsart TWINT
Update Unzer PHP SDK auf 3.7.0
1.5.3 (Juli 2024)
deaktivieren der GiroPay Zahlungsart, da GiroPay den Service eingestellt hat
1.5.2 (Juni 2024)
Einstellung für Acquirer-Ländercode zu Google Pay hinzugefügt
“Discover" und "JCB" aus den unterstützten Kartennetzwerken für Google Pay entfernt
1.5.1 (Juni 2024)
Fehlerbehandlung / Fehlermeldungen beim Löschen oder Speichern eines ungültigen Schlüsselpaares korrigiert
1.5.0 (Mai 2024)
Added: Neue Zahlart Google Pay
Changed: zeige nur die Zahlungsarten für die unterstützten Länder und Währungen an. Dies betrifft die folgenden Zahlungsarten: Alipay, EPS, Giropay, Vorkasse, Przelewy24, SEPA Lastschrift, Lastschrift, SOFORT, WeChat Pay, iDEAL, Bancontact, Ratenkauf, Rechnungskauf
1.4.1 (April 2024)
Changed: Anpassen der Unzer UI Components: Bereits dem Shop bekannte Daten nicht erneut abfragen/anzeigen
Changed: Unzer Direct Debit (Lastschrift) nur für EUR wählbar
Fixed: Validierung der Unzer UI Components
Fixed: Währungsfaktor bei Unzer Ratenkauf (Paylater) berücksichtigen
1.4.0 (April 2024)
Added: Neue Zahlart Unzer Lastschrift (Paylater)
Added: Fehlende Übersetzungen für Unzer Ratenkauf (Paylater)
Changed: Zahlungsarten + Systemvoraussetzungen in Readme angepasst
Fixed: Geburtstagsfeld vorausfüllen sofern schon im Shop gesetzt
Fixed: Problem mit Validierung bei Unzer UI Komponenten
Fixed: Problem mit Session falls im Checkout die Liefer-/Rechnungsadresse geändert wird
v1.3.2 (Januar 2024)
Fixed: API Fehler in den Einstellungen bei initialem Installieren
v1.3.1 (Januar 2024)
Added: API Schlüssel Verwaltung
Added: Neue Zahlart Unzer Ratenkauf (Paylater)
Added: Support für PHP 8.2 und PHP 8.3
Added: Verbessertes Fehlerhandling
Changed: Unzer SDK Update
Changed: Veraltete Zahlungsarten besser hervorheben
v1.3.0 (August 2023)
Added: LICENSE undNOTICE
Changed: Umbenennen von Zahlungsart Unzer Rechnung zu Unzer Rechnung (Paylater)
Fixed: Löschen der Plugin Session auf der Bestellstatus Seite für den Fall, dass der Benutzer den Zahlvorgang abgebrochen hat
Removed: Veraltete Zahlart Unzer Instalment/Unzer Ratenkauf
Removed: Veraltete Zahlart Unzer Bank Transfer/Unzer Direktüberweisung
v1.2.1 (Februar 2023)
Added: Kompatibilität für JTL 5.2 und PHP 8.1 hinzugefügt
Added: Debug-Protokolle für den Versand-API-Aufruf hinzugefügt
Added: Referenztext für Stornierungen hinzugefügt
Changed: Anzeige der Rechnungs-ID in den Bestelldetails nur, wenn entweder die lokale Rechnungs-ID oder die Rechnungs-ID aus der API-Antwort verfügbar ist
Changed: Unzer Insight Portal Button ausblenden, da der korrekte Link zur Bestellung nicht zuverlässig ermittelt werden kann
Fixed: Fehlerhaftes Spach-Mapping für Unzer UI-Komponente behoben
Fixed: Problem mit Unzer Applepay-Debugging im Sandbox-Modus
Fixed: Problem behoben, bei dem der Submit-Button bei ungültigen Eingaben im zusätzlichen Checkout-Schritt deaktiviert bleibt
Fixed: Potentielles Rundungsproblem im API-Feld für den Gesamtbruttobetrag behoben
v1.2.0 (November 2022)
Added: Bancontact als Zahlungsmethode hinzugefügt
Added: Unzer Rechnung (Jetzt kaufen, Später Bezahlen) als Zahlungsmethode hinzugefügt
Added: Option hinzugefügt, um das automatische setzen von Zahlungseingängen zu deaktivieren
Change: Unzer SDK Version auf 1.2.0.0 aktualisiert
v1.1.0 (Juli 2022)
Added: Firmeninfo zum Kundenobjekt hinzugefügt
Added: Überprüfung und Benachrichtigung hinzufügen, falls sich die Frontend-URLs aufgrund von JTL-/Plugin-Updates geändert haben und wie man sie korriegiert
Added: Hinzufügen des MwSt.-Betrags zum Warenkorb Objekt
Added: ApplePay Zahlungsmethode hinzugefügt
Change: Unzer SDK Version auf 1.1.4.2 aktualisiert
Change: Standardwert für die Auswahl der Zahlungsmethode entfernen, da das NOVA-Theme bereits einen Zurück-Button im zusätzlichen Zahlungsschritt hat
Fixed: Problem mit Ratenzahlungen behoben, die falsche/temporäre Bestellnummern an Unzer übermitteln
Fixed: Behebung eines unbehandelten Fehlers beim Abrufen von Erstattungen im Backend
Fixed: Problem mit Umlauten im Zahlungszwischenschritt behoben, die mit HTML Entities statt UTF8 kodiert wurden
Fixed: Problem mit der Stornierung von Invoice (Secured) Bestellungen vor deren Abschluss behoben
Fixed: Problem mit falscher Bestellnummer in Bestellbestätigungsmails behoben
v1.0.2 (März 2022)
Added: Hinzufügen von Mindestangaben zum Kunden (Name und E-Mail) zu allen Zahlungen
Change: Short-ID als Transaktions-ID im Zahlungsverlauf verwenden (WaWi)
Fixed: Setzen der Standard-DB-Engine und des Zeichensatzes beim Erstellen von Datenbanktabellen, um Probleme aufgrund seltsamer Standardwerte zu vermeiden
Fixed: Fehlerbehandlung hinzugefügt, um Probleme im Frontend zu vermeiden, wenn die API nicht aufrufbar ist (z.B. fehlende Schlüssel)
Fixed: Behebung des Problems, dass -0.0 in der Unzer-API als negativ interpretiert wird
Fixed: Behebung einer möglichen Fehlanpassung der Bestell-IDs zwischen dem Unzer Insight Portal und dem Shop
Fixed: Fehler im Platzhalter der Public-Key Einstellung im Backend
v1.0.1 (November 2021)
Added: PHP 8.0 Kompatibilität
Added: JTL Shop 5.1 Kompatibilität
Added: JTL WaWi 1.6 Kompatibilität
Fixed: Schreibfehler in SQL Abfrage
Fixed: Anzeigefehler bei Stornierungen die die gleiche ID haben, obwohl sie in verschiedenen Transaktionen sind
Fixed: Problem bei der Validierung, wodurch Gutscheine auf der “Zusammenfassung”-Seite im Checkout nicht eingelöst werden können
v1.0.0 (Juli 2021)
Offizielles Release
v0.9.8 (Juli 2021)
Change: "Unzer Rechnungskauf" deaktiviert, da diese mit "Unzer Rechnung (secured)" zusammengelegt wurde
Change: Zahlungsinformationen für "Vorkasse" und "Rechnung" auf der Bestellabschluss-Seite hinzugefügt
Bugfix: Fehlende Übersetzungen hinzugefügt
v0.9.7 (Juni 2021)
Change: Zahlungsartennamen angepasst
Bugfix: Problem beim stornieren von Ratenkäufen
Bugfix: Transaktionen die bereits Geld eingezogen haben, können nicht storniert werden
Bugfix: Pending Charges werden nicht storniert
Bugfix: Probleme mit dem B2B Kundenformular
v0.9.6 (Mai 2021)
Bugfix: Konflikt zwischen Standard EVO styles und unzerUI form Labels (alles uppercase)
Bugfix: Firma vorausfüllen bei B2B Customer Formular
Bugfix: Beim erfolgreichen Verarbeiten einer Charge wird ein Eintrag ins Error-Log geschrieben
Bugfix: Im Webhook übergebene Charge enthält nicht immer alle nötigen Informationen was zu einer falschen oder gar keinen Verarbeitung der Zahlungseingänge führt
Change: Vor- und Nachname bei B2B Customer Formular werden nicht mehr vorausgefüllt
Change: Beim registrieren der Webhooks werden bestehende Webhooks nicht vorher gelöscht
Change: “guaranteed” in “secured” umbenannt wo möglich
Change: Metadaten hinzugefügt
v0.9.5 (April 2021)
Bugfix: CVC Feld bei Kreditkarten im Firefox sichtbar, wenn eine Schriftart konfiguriert ist.
Bugfix: Falsche Warenkorb Berechnung bei “Ratenzahlung”, wenn Gutscheine benutzt werden.
v0.9.4 (April 2021)
Bugfix: Fehlenden PQ Selector für Fehlermeldungen auf der Bestellstatus Seite nach Bestellabschluss hinzugefügt.
v0.9.3 (März 2021)
Bugfix: API Fehler wenn Kupons genutzt werden bei Zahlungsarten die den Warenkorb übermitteln
Bugfix: Fehlendes Error Handling bei Zahlungsart-Zusatzschritt
Bugfix: E-Mail Adresse beim Customer-Object hinzugefügt (Pflicht bei Gast-Bestellungen)
Bugfix: B2B Kunden Daten werden nicht richtig abgefragt / an Unzer übermittelt
Bugfix: Stornieren von Bestellungen wird bei "Rechnung" nicht an Unzer übermittelt
v0.9.2 (März 2021)
Bugfix: Sonderzeichen in der basketReferenceId entfernen
v0.9.1 (Februar 2021)
Bugfix: Plugin Session nach Fehler löschen, um Fehler durch alte Session Daten zu vermeiden.
Bugfix: Ungültige Zeichen (Leerzeichen) in der basketReferenceId ersetzen
v0.9.0 (November 2020)
Initiales Release (Beta)
Support und Kontakt
siehe Support und Kontakt