SAP Commerce Cloud

Plugin installieren

Der erste Schritt zur Nutzung des Plugin ist die Installation. Vorab sollten Sie sicherstellen, dass Ihre Infrastruktur die folgenden Systemanforderungen erfüllt:

Zusätzlich zu diesen Voraussetzungen sollten Sie die Erweiterungsstruktur berücksichtigen:

Danach führen Sie die folgenden Schritte aus:

Installieren Sie SAP Commerce mit „cx“ Recipe

SAP bietet im SAP Help Portal Anweisungen, wie die Installationsrezepte zu nutzen sind. Wenn Sie mit der Installation noch nicht vertraut sind, sollten Sie diese vorher lesen.

• Laden Sie SAP Commerce im .Zip-Format herunter. Dekomprimieren Sie die Plattform und navigieren Sie zum Verzeichnis „Installer“.
• Führen Sie den folgenden Befehl aus. Ersetzen Sie „your_password“ mit dem erwünschten Administratorpasswort für das System:

./install.sh -r cx -A local_property:initialpassword.admin=your_password

• Führen Sie die folgenden Schritte aus, um das System zu erstellen und zu initialisieren:

./install.sh -r cx initialize -A local_property:initialpassword.admin=your_password

• Erweitern Sie die Codebasis
  Die Datei herunterladen und dekomprimieren
• Bestätigen Sie, dass Sie die folgende Verzeichnisstruktur erhalten haben:

hybris/
           config/
           bin/
                       custom/
                                     worldline/

• Das Konfigurationsverzeichnis enthält ein Musterset mit Konfigurationen in der Datei local.properties. Kopieren Sie diese Konfigurationen in die Datei local.properties, die nach der Installation von SAP Commerce generiert wurde
• Das Konfigurationsverzeichnis enthält auch eine Datei localextensions.xml. Fügen Sie Folgendes aus dieser Datei Ihrer eigenen Datei localextensions.xml hinzu, die Sie nach der Installation von SAP Commerce generiert haben:

<!-- WORLDLINE -->
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectcore"/>
You will require an existing installation of SAP Commerce in order to be able to use the Worldline Direct
plugin. If you already have an installation of SAP Commerce with the B2C Accelerator and its
corresponding extensions included, you can skip this step.
Worldline – SAP Commerce Cloud Documentation
Technical Documentation – 9
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/
worldlinedirectb2ccheckoutaddon"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectbackoffice"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectocc"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectwebhook"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/
worldlinedirectcustomersupportbackoffice"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/
worldlinedirectfulfilmentprocess"/>

• Das Verzeichnis bin/custom/worldline enthält alle erforderlichen Erweiterungen. Kopieren Sie sie in Ihr eigenes Verzeichnis hybris/bin/custom/worldline. Wenn Sie diese Erweiterungen in ein anderes Verzeichnis kopieren möchten, aktualisieren Sie Ihr localextensions.xml entsprechend.

Storefront erweitern

• Sie müssen möglicherweise den folgenden Befehl ausführen, um sicherzustellen, dass die richtigen Addons in Ihrem Storefront verfügbar sind:

  
   ant addoninstall
   
-Daddonnames=
   
"adaptivesearchsamplesaddon,assistedservicecustomerinterestsaddon,assistedserviceprom
   
otionaddon,assistedservicestorefront,assistedserviceyprofileaddon,captchaaddon,config
   
urablebundleaddon,consignmenttrackingaddon,customercouponaddon,customercouponsamplesa
   
ddon,customerinterestsaddon,customerticketingaddon,eventtrackingwsaddon,merchandising
   
addon,merchandisingstorefrontsampledataaddon,multicountrysampledataaddon,notification
   
addon,ordermanagementaddon,orderselfserviceaddon,pcmbackofficesamplesaddon,personaliz
   
ationaddon,personalizationsampledataaddon,personalizationyprofilesampledataaddon,prof
   
iletagaddon,selectivecartsplitlistaddon,smarteditaddon,stocknotificationaddon,textfie
   
ldconfiguratortemplateaddon,timedaccesspromotionengineaddon,timedaccesspromotionengin
   
esamplesaddon,xyformssamples,xyformsstorefrontcommons,ysapproductconfigaddon"
   
-DaddonStorefront.yacceleratorstorefront="<YOUR-STOREFRONT>"

  

Ersetzen Sie <YOUR-STOREFRONT> mit dem Namen der Erweiterung Ihres Storefront, z.B. yacceleratorstorefront oder <project>storefront.

• Installieren Sie das Addon mit dem folgenden Befehl in Storefront:

ant addoninstall -Daddonnames="worldlinedirectb2ccheckoutaddon"
-DaddonStorefront.yacceleratorstorefront="<YOUR-STOREFRONT>"<your-storefront></your-storefront>"

• Nun bauen Sie Ihr System um:

ant clean all

• Nun entweder initialisieren oder das System aktualisieren. Sie können beides über die Hybris Administration Console (HAC) unter https://<your-server>:9002/hac tun oder Sie initialisieren über das ant-Ziel:

ant initialize

Plugin konfigurieren

Nach der Installation müssen Sie das Plugin konfigurieren, um Ihren Store mit unserer Plattform zu verbinden.

Dieser Abschnitt der Dokumentation befasst sich nur mit technischen Konfigurationselementen. Für eine Unternehmenskonfiguration im SAP Backoffice ist dieser Abschnitt von Bedeutung.

Merkmale konfigurieren

• Von worldlinedirectcore/project.properties:

worldline.direct.api.authorizationType=V1HMAC
worldline.direct.api.connectTimeout=10000
worldline.direct.api.socketTimeout=10000
worldline.direct.api.maxConnections=10
worldline.direct.api.integrator=Worldline

Das Java SDK übergibt diese Konfigurationen und kontrolliert die Verbindung. In unserer Java SDK Dokumentation finden Sie mehr Informationen.

• Von worldlinedirectbackoffice/project.properties:

worldline.contact.support.default.cc=
worldline.contact.support.default.bcc=
worldline.contact.support.default.subject=default subject

Diese Konfigurationen steuern die Schaltfläche innerhalb des SAP Back Office, die dazu dient, per E-Mail unsere Unterstützung anzufordern.

• Von worldlinedirectocc/project.properties:

worldline.occ.hostedCheckout.returnUrl=https://localhost:9002/occ/v2/%s/users/%s/orders/%s/hostedcheckout
worldline.occ.hostedTokenization.returnUrl=https://localhost:9002/occ/v2/%s/users/%s/orders/%s/hostedtokenization/return3ds

Diese Konfigurationen setzen den Wert fest für das Merkmal der Server API HostedCheckoutSpecificInput.ReturnUrl, damit Ihre Kunden wieder korrekt zu Ihrer Webshop-Umgebung weitergeleitet werden. Es ist wichtig, diese Werte zu aktualisieren, damit sie die URL Ihres Systems wiedergeben.

Webhooks konfigurieren

Das Plugin nutzt Webhooks, um den aktuellen Status Ihrer Transaktionen von unserer Plattform abzurufen. SAP Commerce verwendet den Endpunkt /worldline/webhook, um diese Aktualisierungen des Status zu erhalten.

Konfigurieren Sie einen WebhooksKey, WebhooksKeySecret und Endpoint URLs in Ihrer PSPID, so wie in unserer Anleitung beschrieben. Achten Sie darauf, dass die URL

• den Hostname Ihrer Site enthält '(z.B. https://<your-domain>:9002/worldline/webhook)'
• über ein gültiges SSL-Zertifikat verfügt

SAP konfigurieren

Die folgenden Schritte bilden das Konfigurationsverfahren für das Tool SAP Commerce Backoffice. Allgemeine Informationen zum SAP Commerce Backoffice finden Sie in den Anleitungen für geschäftliche Nutzer im SAP Help Portal.

Nach der erfolgreichen Installation enthält das SAP Backoffice einen neuen Elementtyp "Worldline Configuration". Mit diesen Schritten verbinden Sie Ihren Base Store in SAP Commerce mit unserer Plattform:

• Loggen Sie sich in das SAP Commerce Backoffice ein mit der Standard-URL https://<hostname>:9002/backoffice. Die Standardanmeldedaten für den Administrator wurden während der Installation festgelegt oder sie wurden Ihnen getrennt zugestellt

Gehen Sie zu Worldline > Worldline Konfiguration. Klicken Sie auf das „+“ - Symbol auf der Taskleiste.

• Geben Sie Folgendes aus der Tabelle aus dem Pop-up-Fenster, das erscheint, ein:

Klicken Sie zur Bestätigung auf „FERTIG“.

• Klicken Sie auf das Konfigurationsprofil in der Tabelle, die Sie gerade bestätigt haben. Geben Sie Folgendes aus der Tabellenübersicht an:

Klicken Sie zur Bestätigung Ihrer Konfiguration auf „SPEICHERN“.

Base Store konfigurieren

Bevor Sie mit der Verarbeitung von (Test-) Transaktionen beginnen, müssen Sie

• Ihre Base Stores mit der Plugin-Konfiguration verbinden
• einen Integrationsmodus wählen.

Zu diesem Zweck führen Sie die folgenden Schritte aus, indem Sie bei jedem Tab auf „SPEICHERN“ klicken:

• Gehen Sie zu Base Commerce > Base Store. Wählen Sie den Store aus der Tabelle mit den Überschriften „ID“ / „Name“.

Wählen Sie „Worldline“ aus den verfügbaren Tabs und scrollen Sie herunter zu „WORLDLINE KONFIGURATION“.

• Geben Sie Folgendes aus der Tabellenübersicht an:

• Wählen Sie „ADMINISTRATION“ aus den verfügbaren Tabs und scrollen Sie herunter zu „UNBOUND“. Geben Sie „worldlineB2CResponsiveCheckoutGroup“ in das Feld „Checkout Flow Group“ ein.
  

Wählen Sie „PROPERTIES“ aus den verfügbaren Tabs aus und scrollen Sie herunter zu „PAYMENT PROVIDER“. Geben Sie in das Feld „Payment Provider“ „Worldline“ ein.

Testverbindung

Nachdem Sie alle Schritte ausgeführt haben, verifizieren Sie die Konfiguration, indem Sie eine Testverbindung zwischen dem Plugin und unserer Plattform herstellen.

• Gehen Sie zu Worldline > Worldline Configuration. Wählen Sie das Konfigurationsprofil aus der Tabelle mit den Überschriften „Merchant ID“ / „API Key“ aus.
• Klicken Sie in der Übersicht für das Konfigurationsprofil auf „Testverbindung“. Überprüfen Sie, ob im Pop-up-Fenster, das erscheint, „OK (success)“ angezeigt wird. Wenn das Pop-up-Fenster einen fehlgeschlagenen Test meldet, wenden Sie sich zwecks Behebung des Fehlers an Ihren Systemadministrator.

Configure Payment Modes

To configure the list of payment modes, go to Price settings > Payment Modes. 

This list shows all available payment methods in your system. (De)activate any payment method by setting the "Is Active" flag accordingly. Once a new payment method has been added to your Worldline account, you may have to add in manually. To do so, click on the "+" button on top of the list. 

Configure Card On File

To configure Card On File, go to Worldline > Worldline Recurring Token. 

This list shows all available tokens for Card On File in your system. Click in the respective line in the table to get a comprehensive overview about the individual token and possible actions: 

Manage SEPA mandates

To manage mandates for SEPA Direct Debits payments, go to Worldline > Worldline Mandates > ORGANIZATION or ADDRESS tab. 

This list shows all available mandates in your system. Click in the respective line in the table to get a comprehensive overview about the individual mandate and possible actions: 

Zahlungen verwalten

Unser Plugin ist so konzipiert, dass Ihre Aufträge automatisch und autonom bearbeitet werden. Das befreit Sie von lästigen Verwaltungsarbeiten. Hier erfahren Sie, wie Sie Ihr Plugin effektiv für Ihre Geschäfte nutzen können.

Wartungsmaßnahmen durchführen

Erfassen, Gutschriften und die Stornierung von Autorisierungen sind Standardverfahren (auch bekannt als Wartungsmaßnahmen) Ihrer täglichen Geschäftsabläufe. Hier erfahren Sie, wie Sie diese Operationen im SAP Backoffice ausführen.

Testtransaktionen durchführen

Testtransaktionen durchführen

Verwenden Sie die Test-Umgebung unserer Plattform, um sicher zu gehen, dass Ihr Plugin wie gewünscht funktioniert. Wir bieten Testdaten auf unserer eigens dafür eingerichteten Testszenarios-Seite. Steuern Sie unsere Test-Umgebung wie im Kapitel "Plugin konfigurieren" beschrieben an.