For english-version click HERE

Dieses Modul ermöglicht Ihnen die Erweiterung Ihres OXID eShops um die von Kustom bereitgestellten Zahlungsarten. Der „Kustom Checkout“ integriert die Zahlungsarten „Klarna Kauf auf Rechnung“, „Klarna Ratenkauf“, Lastschrift und Kreditkartenzahlungen per Visa oder MasterCard in einer revolutionär einfachen Checkout-Lösung. Ihre Kunden müssen nur noch Daten angeben, die sie ohnehin immer im Kopf haben. Dies vereinfacht das Einkaufen enorm und lässt Ihre Konversionsrate förmlich explodieren – vor allem auf Smartphones und Tablets. Nach der Installation dieses Moduls und anschließenden Aktivierung des Kustom Checkouts bekommen Ihre Kunden die Möglichkeit, direkt von der Produkt-Detailseite oder aus dem Mini-Basket heraus zum Kustom Checkout zu wechseln. Hier können Kunden dann einfach durch Eingabe von E-Mail-Adresse und Postleitzahl den Einkauf abschließen.

Für die Verwendung des OXID 7 Kustom Checkout Moduls sind folgende Systemvorrausetzungen notwendig:

• Installierter und lauffähiger OXID eShop ab Version 7.0
• Kustom Händlerkonto
• PHP Version ab 8.0 bis 8.4
• Shop muss mit einem SSL-Zertifikat laufen und die https-Adresse muss in der Shop-Config hinterlegt sein
• Für automatische Zahlungsstatus-Updates muss der Shop extern erreichbar sein
• Der Server, auf dem das OXID 7 Kustom Checkout Modul für den OXID eShop genutzt werden soll, muss selbstverständlich den OXID Server- und Systemvoraussetzungen entsprechen:
  https://docs.oxid-esales.com/eshop/de/7.1/installation/neu-installation/server-und-systemvoraussetzungen.html

Kustom sendet zur Validierung von Transaktionen Requests an Ihren OXID eShop.

Damit solche Callback Aufrufe von Kustom an Ihren Shop erfolgen können, muss Ihr Shop frei von draußen über das Internet erreichbar sein. Das heißt, es darf weder einen Passwortschutz, noch eine IP-Sperre oder einen Firewallschutz in Ihrem Shop aktiv sein, der Kustom daran hindert, die entsprechenden Informationen an den Shop zu senden.

Denken Sie insbesondere daran, wenn Sie in Ihrer Entwicklungs- oder Stage-Umgebung testen wollen: HTTPS-Aufrufe von den externen Kustom Servern auf Port 443 Ihres Servers müssen erlaubt sein.

Für die Installation des OXID 7 Kustom Checkout Moduls führen Sie die nachfolgenden Schritte aus:

• Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
• Führen Sie folgenden Befehl aus:

  composer require fatchip-gmbh/kustom-checkout-oxid7

• Aktivieren Sie anschließend das Modul über „Erweiterungen“ → „Module“ → „Kustom Checkout“ → „Stamm“ und klicken Sie auf „Aktivieren“

Die aktuelle Versionsnummer des OXID 7 Kustom Checkout Moduls erhalten Sie unter https://github.com/FATCHIP-GmbH/kustom-checkout-oxid7/releases
Für Plugin-Updates können Sie auch unseren LinkedIn-Account: https://de.linkedin.com/company/fatchip folgen.

Um das Kustom Checkout Modul für OXID 7 zu aktualisieren, müssen Sie die nachfolgenden Schritte ausführen:

• Loggen Sie sich per sFTP/FTP auf Ihren Server ein und wechseln Sie in das Rootverzeichnis des Shops
• Öffnen Sie die composer.json und ändern Sie die angegebene Version auf die Version, auf die Sie aktualisieren möchten
  
• Loggen Sie sich auf die Kommandozeile (CLI) ein und navigieren Sie zum Rootverzeichnis des Shops
• Führen Sie den folgenden Befehl aus:

  composer update

• Loggen Sie sich in den Admin Ihres OXID eShops ein
• Rufen Sie das Plugin unter Erweiterungen → Module auf
• Deaktivieren Sie das Plugin und Aktivieren Sie es wieder

Im eShop Admin Haupt-Menü taucht die neue Rubrik „Kustom“ links mit mehreren Unter-Menüeinträgen auf:

Für eine detaillierte Beschreibung der verschiedenen Einstellungen beachten Sie bitte die Tooltips [?]

Auf dieser Seite können Sie die Kustom Checkout spezifischen Einstellungen konfigurieren.
Für eine detaillierte Beschreibung der verschiedenen Einstellungen beachten Sie bitte die Tooltips. [?]

Hier können Sie die Design Einstellungen zur Verwendung mit dem Kustom Modul für den OXID eShop konfigurieren. Für eine detaillierte Beschreibung der verschiedenen Einstellungen beachten Sie bitte die Tooltips [?]

Wählen Sie hier, ob das Kustom Logo im Footer Ihres Shops eingebunden werden soll.

Mit diesen Einstellungen können Sie das Look'n'Feel des Kustom Checkout Iframes Ihrem Shop Layout anpassen. Lassen Sie die Felder einfach leer, um das Kustom Standard Farbschema zu verwenden.

Tipp: Bei Klick in eines der Farb-Felder öffnet sich ein komfortabler Farbwähler, so dass der hexadezimale Farbcode automatisch ins Feld eingetragen wird. Die Radius Einstellung wirkt sich unmittelbar auf das Eingabefeld selbst aus, damit man direkt ein Bild davon hat, wie der gewählte Radius im Frontend aussieht.

Sie haben die Möglichkeit innerhalb des Kustom Checkout Iframes neben den herkömmlichen Kustom Zahlungsarten weitere externe Bezahlmethoden zu integrieren.

Das Kustom Checkout und Kustom Payments Modul für den OXID eShop enthält bereits die Implementierung zur Verwendung der folgenden externen Bezahlmethoden, die im Standard-Funktionsumfang des OXID eShop vorhanden sind:

• Nachnahme
• Vorauskasse

Das bedeutet, wenn Sie z.B. „Nachnahme“ als externe Bezahlmethode aktivieren, dann können Ihre Kunden im Shop Frontend in den Kustom Checkout starten und dort dann als Zahlungsart „Nachnahme“ direkt innerhalb des Kustom Checkout Iframes auswählen. Der Vorteil ist, dass auch im Falle solch einer Gast-Bestellung per Nachnahme automatisch die Adressdaten vorausgefüllt werden, wenn:
a) der Browser des Kunden von Kustom per Cookie wieder erkannt wurde, nachdem bereits zuvor mit diesem Browser ein Kustom Einkauf getätigt wurde - ODER -
b) der Kunde von Kustom nach Eingabe seiner E-Mail-Adresse und Postleitzahl wieder erkannt wird, nachdem der Kunde bereits zuvor einen Kustom Einkauf in demselben oder einem beliebigen anderen Shop mit diesen Daten getätigt hat Weitere externe Bezahlmethoden können per Modul ergänzt werden. Siehe Kapitel „Module für externe Bezahlmethoden“.

Folgende Module können mit dem vorliegenden Kustom Checkout und Kustom Payments Modul für den OXID eShop zusammen verwendet werden:

• Amazon Pay & Login 4 OXID von der best it GmbH & Co. KG
• PayPal Modul von der OXID eSales AG

Beide Module stellen Funktionalitäten bereit, die es ermöglichen, Amazon Pay bzw. PayPal jeweils als „Externe Bezahlmethode“ in Ihrem Online-Shop zu aktivieren.

Ferner besteht die Möglichkeit für Entwickler, die modul-seitig bereits vordefinierten Zahlungsarten um weitere externe Bezahlmethoden hinzuzufügen. Bitte beachten Sie, dass diese ggf. im Einklang mit den zwischen Ihnen und Kustom geschlossenen Verträgen stehen müssen. Die im Paket-Umfang des vorliegenden Kustom Checkout und Kustom Payments Modul für den OXID eShops enthaltenen Integrationen für Vorkasse, Nachnahme, Amazon Pay und PayPal können dabei als Vorlage verwendet werden. Erweitern Sie die Controllers/KustomOrderController.php und ergänzen Sie entsprechende Aktionen für Ihre neuen Bezahlmethoden in der Methode KustomExternalPayment(). Außerdem ergänzen Sie den Namen Ihrer neuen Zahlungsart durch Erweiterung der Core/KustomConsts.php in der Methode getKustomExternalPaymentNames(). Dabei dürfen nur von Kustom freigegebene Namen verwendet werden. Wenden Sie sich bei Interesse gern an Ihren Kustom Integration Manager.

Unter dem Menüpunkt „External Payment Methods“ werden Ihnen alle Zahlungsarten aufgelistet, die Sie im Bereich Shopeinstellungen → Zahlungsarten eingerichtet und aktiv geschaltet haben. Für jede Zahlungsart können Sie hier nun folgende Einstellungen vornehmen:

Hier werden die Bilder für External Payment Methods im Kustom Checkout Iframe dargestellt:

Aktivieren Sie die Funktionen auf dieser Seite lediglich, falls Sie entsprechend von Ihrem Kustom Integration Manager instruiert wurden.

Kustom Extra Merchant Data bezeichnet zusätzliche Informationen über Ihre Kunden, die ggf. von Ihrem Shop automatisch an Kustom übertragen werden und seitens Kustom für eine bessere Risikoeinschätzung erforderlich sind.

Mit „Customer Account Info“ werden Informationen über das Kundenkonto an Kustom übermittelt: Wann wurde das Konto angelegt, wann wurde es zuletzt verändert.

Die „Payment History Full“ übertägt Informationen über die Anzahl und Summen der Käufe eines Kunden, das Datum des ersten und letzten Kaufs sowie die verwendete Bezahltmethode. Wenn Sie diese Informationen an Kustom übertragen, weisen Sie bitte für jede Bezahlart im Shop einmal zu, um welchen Typ der Zahlungsart es sich handelt und ob und ggf. wie diese Bestellungen als bezahlt an Kustom gemeldet werden sollen.

Mit Hilfe des Pass-through Feldes „merchant_data“ können Sie bei Bedarf individuelle Zusatz-Informationen zu einer Bestellung an Kustom übergeben. Auf diese Daten können Sie später mittels API bei jedem Abruf der Bestelldaten von Kustom wieder zugreifen. Sie können in diesem Feld z.B. eine einfache Zeichenfolge aber auch eine komplexe JSON Struktur als String an Kustom übertragen.

Wird der entsprechende Schalter im Admin-Backend gesetzt, so wird die Methode getPassThroughField() der Klasse KustomPassThrough ausgeführt. Diese Klasse liefert standardmäßig eine leere Antwort zurück. Um entsprechend individuelle Informationen an Kustom zu übertragen, muss diese Klasse mit Hilfe eines eigenen Moduls überladen werden.

Dies ist der einfachste Weg, um Zusatz-Informationen an Kustom zu übermitteln. Näheres hierzu erfahren Sie in der Entwickler-Dokumentation.

Hier ist ein Beispiel für ein individuelles Erweiterungs-Modul:

class your_module_pass_through extends your_module_pass_trough_parent
{
 public function getPassThroughField()
 {
 $mainData = „any custom string“;
 return $mainData;
 }
}

Ihr Modul müssen Sie über die Metadata.php in Ihrem Shop bekannt machen.

Ein weiterer, etwas komplexerer Weg, um Zusatz-Informationen an Kustom übermitteln, ist, das Kustom Modul mit einem individuellen Modul zu erweitern um weitere Informations-Pakete wie Travel, Event, Voucher oder Subscription an Kustom zu übermitteln.

Hier ist ein Beispiel für ein individuelles Erweiterungs-Modul:

class your_module_Kustom_emd extends your_module_Kustom_emd_parent
{
 public function getAttachments($oxUser)
 {
 $mainData = parent::getAttachments($oxUser);
 $myEMDData = array('your_custom_info' =>
 array('example_field' => 'example data')
 );
 return array_merge($mainData, $myEMDData);
 }
}

Ihr Modul müssen Sie über die Metadata.php in Ihrem Shop bekannt machen.

Unter dem Menü-Punkt „Versandarten“ im Bereich des Kustom Menüs befindet sich die Zuordnung der Versandarten zu den von Kustom definierten Versand-Methoden für den Kustom Checkout.

Hiermit teilen Sie Kustom mit, dass z.B. eine in OXID zuvor angelegte Versandart „Abholung“ der Kustom Methode „PickUpStore“ entspricht. Dieses Matching von den in OXID angelegten Versandarten zu den bei Kustom üblichen Bezeichnungen wird hier für alle Versandarten einmal hinterlegt.

Die Zuordnung der Versandarten ist freiwillig. Sie können die Auswahl auch leer lassen. Ein akkurate Zuordnung erleichtert Kustom jedoch das Einschätzung von Risikoprüfungen und den Kundenservice bei Rückfragen zur Bestellung.

Falls Sie Packstation Lieferungen unterstützen möchten, ist eine Zuordnung jedoch erforderlich wie unter dem nächsten Punkt beschrieben:

Die Versandarten Zuordnung wird außerdem dafür benutzt, festzulegen, welches ggf. DHL Versandarten sind, die eine Lieferung an DHL Packstationen erlauben. Wenn Sie keine Packstation Lieferungen anbieten möchten, wählen Sie „Postal“. Möchten Sie an Packstationen liefern, wählen Sie hingegen „Postal + DHLPackstation“.

Um den Kustom Checkout zu aktivieren, müssen Sie Ihre Merchant ID oder Ihren API-Benutzernamen pflegen und das dazugehörige Passwort unter dem Menüpunkt Kustom → Allgemein eintragen.

Folgende Felder müssen (ggf pro Auswählbarer Sprache) befüllt unter dem Menüpunkt Kustom → Allgemein sowie dem Menüpunkt Kustom → Konfiguration sein:

• URL zu Ihren AGB - Pflichtfeld
• URL zum Widerrufsrecht - Pflichtfeld
• URL zu Versanddetails - Pflichtfeld

Damit der Kustom Checkout korrekt aktiviert werden kann müssen in der Datei config.inc.php die Variablen $this→sSSLShopURL und $this→sAdminSSLURL gepflegt sein.

 
$this->sShopURL     = 'https://IHRE-SHOP.URL'; // eShop base url, required
$this->sSSLShopURL  = 'https://IHRE-SHOP.URL'; // eShop SSL url, required for Kustom-Checkout
$this->sAdminSSLURL = 'https://IHRE-SHOP.URL/admin'; // eShop Admin SSL url, required for Kustom-Checkout

Loggen Sie sich hierfür auf die Kommandozeile (CLI) ein und navigieren Sie zu „Rootverzeichnis des Shops“/source
und bearbeiten sie die config.inc.php.

Navigieren Sie anschließend zu Shopeinstellungen → Zahlungsarten und aktivieren Sie die Zahlungsart Kustom Checkout
und pflegen Sie die Länderzuordnung für den Kustom Checkout im Länder-Tab

Stellen Sie sicher, dass die Zahlungsart Kustom Checkout in Ihren Versandarten unter Shopeinstellungen → Versandarten → Versandart auswählen → Reiter Zahlungsarten zugeordnet ist.