...

• Unzer Alipay

• Unzer Direktüberweisung

• Unzer EPS

• Unzer Giropay

• Unzer iDEAL

• Unzer Kreditkarte

• Unzer Lastschrift

• Unzer Lastschrift (secured)

• Unzer PayPal

• Unzer Przelewy24

• Unzer Ratenkauf

• Unzer Rechnung

• Unzer Rechnung (secured)

• Unzer SOFORT

• Unzer Vorkasse

• Unzer WeChat Pay

• Unzer ApplePay

Features

• viele Zahlungsarten in einem Plugin

...

• JTL-Shop 5.0.0+ und dessen Vorraussetzungen

• PHP 7.1 bis PHP 78.40

• Die folgenden PHP Erweiterungen

  • ext-json

  • ext-curl

...

Sie müssen bei Unzer registriert sein.

Plugin-Installation

Die Installation des Plugins erfolgt im Standardverfahren für JTL-Shop 5, wie es hier beschrieben ist.

Plugin-Update

...

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

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.

...

JTL-Wawi

Zahlungsarten einrichten

Öffnen Sie die Zahlungsartenverwaltung über Zahlungen → Zahlungsarten.

Legen Sie die Zahlungsarten, die Sie nutzen, mit folgenden Namen an:

• Alipay

• Unzer Direktüberweisung

• EPS

• Giropay

• iDEAL

• Kreditkarte

• 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.

Apple Pay

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.

1. Klicken Sie unter “Certificates, Identifiers & Profiles” in der Seitenleiste auf “Identifiers” und dann oben links auf die Schaltfläche “Hinzufügen”

   Image Added

2. Wählen Sie dann in der Liste “Merchant IDs” aus und klicken dann auf weiter (“continue”)

3. Vergeben Sie eine Beschreibung für den Shop und die Kennung (Identifier)

   Image Added

4. Ü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.

1. 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.

   Image Added

2. Unter Händler-Domains (Merchant Domains) klicken Sie auf “Domain hinzufügen” (“Add Domain”)

   Image Added

3. Geben Sie den vollständigen Domain-Namen an und klicken dann auf speichern

   Image Added

4. 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)

   Image Added

5. 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.

1. 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)

2. Laden Sie nun die CSR Datei herunter

   Image Added

3. 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.

   Image Added

4. Klicken Sie unter Apple Pay Händler-Identitätszertifikat (Apple Pay Merchant Identity Certificate) auf Zertifikat erstellen (Create Certificate)

   Image Added

5. Klicken Sie auf Datei auswählen (Choose File) und wählen Sie die in Schritt 2 heruntergeladene Datei aus.

6. Klicken Sie auf Fortfahren (Continue)

7. Klicken Sie auf herunterladen (Download)

8. 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!

   Image Added

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.

1. 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)

2. Laden Sie nun die CSR Datei herunter

   Image Added

3. 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.

   Image Added

4. Klicken Sie unter Apple Pay-Zahlungsverarbeitungszertifikat (Apple Pay Payment Processing Certificate) auf Zertifikat erstellen (Create Certificate)

   Image Added

5. Klicken Sie auf Datei auswählen (Choose File) und wählen Sie die in Schritt 2 heruntergeladene Datei aus.

6. Klicken Sie auf Fortfahren (Continue)

7. Klicken Sie auf herunterladen (Download)

8. 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!

   Image Added

9. 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

• iDEAL

• Kreditkarte

• 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.

...

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 die Rechnungsnummer beim ausführen des Workflows nicht im Shop gespeichert wird und die Rechnungszahlungsarten nicht finalisiert werden können!

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!

...

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

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

...