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

Merchants can now share feedback or request additional features via the “Request a new feature” button inside the plugin.

Click on the configuration profile in the table you have just confirmed. Enter the following from the table overview:

Worldline Tab

3D Secure Configuration (3DS tab)

Click on “SAVE” to confirm your configuration.

Configure Base store

Before you start processing (test) transactions, you need to

• Link your Base stores with the plugin configuration.
• Select an integration method.

To do so, follow these steps and confirm by clicking "SAVE" in each tab:

• Go to Base Commerce > Base Store. Select the store from the table with headers "ID" / "Name".

Select "Worldline" from the available tabs and scroll down to "WORLDLINE CONFIGURATION".

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

Configure Payment Modes

To configure this list of Payment Modes in SAP Commerce, navigate to the following menu in Backoffice:

Once you click on Payment Modes, you will see a list of Payment Modes currently loaded in the system. After selecting a Payment Mode, you can enable or disable it by changing the isActive flag.

If you add a new Payment Mode to your account in the Worldline Merchant Portal, you may need to manually add it to the system by clicking the '+' button at the top of the Payment Modes List.

Usage of Mealvouchers

Our plugin supports the Mealvouchers payment method. You must mark it as eligible to enable it. To flag the products, you can simply edit them individually in the SAP Backoffice.

To do so, follow these steps:

• Log in to the SAP Backoffice as administrator. Go to "Products" on the navigation bar.
• Select the product you wish to configure.
• Go to the Administration tab and search for Worldline Mealvoucher Product Type to find the attribute.
• Choose between three different values:
  • Food and Drink
  • Home and Garden
  • Gifts and Flowers
• Select a value and click "Save".

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: 

Replenishment Orders

Both B2B and B2C storefronts have access to the replenishment order feature. There are several configurations you need to set to customise it, which we have explained in the previous sections.

Replenishment orders are created using a cronjob. You need the following properties for replenishment order processes:

• Cart – This is the blueprint of the replenishment order.
• Orders – List of orders placed using the Cart data. The first placed order is the one that the customer places manually during the checkout process. All subsequent orders are created from the cronjob.
• CronJobHistoryEntries – Keeps information about cronjob executions.
• Payment Info – The payment info used for server-to-server calls to Worldline used to process payments for subsequent orders.
• Submitted – This property is used to indicate there were no issues during cronjob creation. If it is set to false, no future orders will be created.

You can find all detailed configurations and processes in the README guide shipped with the plugin package.

We have designed the plugin to follow up on your orders automatically and autonomously, freeing you from the administration involved. Learn here how to use our plugin effectively, which could help your business to thrive!

Perform maintenance operations

Captures, refunds and cancellations of authorisations are standard processes (also known as maintenance operations) in your everyday business logic. You can perform these operations on a transaction using the Customer Support Backoffice.

Once you log in to the Customer Support Backoffice, all orders will be listed in the Orders section. You can select the order you want to perform maintenance operations on.

You can perform actions like capturing or cancelling payments from the options available at the top of the order details section. Cancelling an order will trigger a refund request or authorisation cancellation where applicable.

Managing recurring tokens

Maintenance operations also allow you to manage recurring tokens. You may Block, Unblock, or Revoke them.

Managing mandates

You can manage the status of mandates through the following actions: Block, Unblock or Revoke.

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.