Salesforce 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:

Danach führen Sie die folgenden Schritte aus:

1. Cartridge installieren
   Sie können die Cartridge mit Storefront Reference Architecture (SFRA) nutzen. Installieren Sie die Cartridge in Ihrem Projekthauptverzeichnis auf derselben Ebene wie die Storefront Reference Architecture. Schauen Sie sich als Beispiel die Struktur dieses Ordners an:

   
   my-project/
   |-- link_worldline_direct/
   |  |-- cartridges/
   |  |  |-- bm_worldline_direct/
   |  |  |-- int_worldline_direct/
   |  |-- documentation/
   |  |-- metadata/
   |-- storefront-reference-architecture
   |  |-- cartridges/
   |  |  |-- app_storefront_base/
   |  |  |-- modules/
   

1. Node Module installieren
   Vom Cartridge Hauptverzeichnis aus installieren Sie Node Module mit Ihrer Befehlszeile:

   
   npm install
   
   

2. Code erstellen
   Vom Cartridge Hauptverzeichnis aus kompilieren Sie die kundenseitigen Assets mit Ihrer Befehlszeile:

   
   npm run build
   
   

3. Code hochladen
   Laden Sie int_worldline_direct und bm_worldline_direct mit Hilfe von Commerce Cloud UX Studio hoch oder mit
   sgmf-scripts command line utils.
   
   
4. Metadaten importieren
   Um neue Konfigurationselemente hinzuzufügen, importieren Sie die vordefinierten Metadaten in den folgenden Schritten:
   • Öffnen Sie den Ordner /metadata/site_import/sites/.
   • Benennen Sie den Ordner yourSiteId in die ID auf Ihrer Site im Business Manager um.
   • Komprimieren Sie den Ordner site_import.
   • Gehen Sie im Business Manager zu Verwaltung > Site Entwicklung > Site Import & Export und importieren Sie die komprimierte Datei.
   
   
   Nach dem Import werden Attribute mit der Bezeichnung WorldlineDirect[attributeName] zu Verwaltung > Site Entwicklung > hinzugefügt:
   
   System Objekt Typen > Site Präferenzen > Attribut Definitionen
   System Objekt Typen > Bestellung > Attribut Definitionen
   System Objekt Typen > BestellungZahlungsInstrument > Attribut Definitionen
   System Objekt Typen > KundeZahlungsInstrument > Attribut Definitionen
   Objekt Typen anpassen
   
   Der Dienst worldline.https.direct.yourSiteId wird Verwaltung > Operationen > Dienste hinzugefügt.

Plugin konfigurieren

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

Loggen Sie sich in den Business Manager ein. Stellen Sie die folgenden Werte in den Menüs ein und bestätigen Sie durch Klicken auf „Anwenden“ oder „Speichern“.

Cartridge Paths einrichten

Um ein externes Modul zu integrieren und mit dem Business Manager zu verbinden, führen Sie diese Schritte aus:

• Gehen Sie zu Verwaltung > Sites > Sites managen > [yourSite] > Einstellungen. Geben Sie Folgendes in "Cartridges" ein:

int_worldline_direct:app_storefront_bass

• Gehen Sie zu Verwaltung > Sites > Sites managen > Business Manager Site managen > Einstellungen. Geben Sie das Folgende vor allen sonstigen bestehenden Cartridges ein:

bm_worldline_direct:int_worldline_direct:bm_app_storefront_base:bm_custom_plugin

Genehmigungen für Business Manager definieren

Managen Sie die Zugriffsrechte auf das Modul, damit die Interaktion mit Ihrem Business Manager und Storefronts reibungslos verläuft:

• Gehen Sie zu Verwaltung > Organisation > Rollen & Genehmigungen. Klicken Sie auf die Rolle, die Sie in der Tabelle aktualisieren möchten. Gehen Sie zu Business Manager Module
• Im Pop-up „Kontext wählen“ wählen Sie alle Storefront Sites aus, die Worldline-Direct Payments Cartridge nutzen werden.

Anmeldedaten für Test-/Live-Umgebung konfigurieren

Um unsere Test-/Live-Umgebung zu betreten und um sicherzustellen, dass Ihre Anfragen legitim sind, müssen Sie URL-Endpunkte und ein Paar API-Schlüssel/Geheimnis konfigurieren, die mit einer bestimmten PSPID verbunden sind.

• Gehen Sie zu Verwaltung > Operationen > Dienste. Öffnen Sie den Tab „Anmeldedaten“
• Klicken Sie auf den worldline.https.direct.yourSiteId.TEST in der Spalte „Name“ in der Tabelle, um entweder Test oder Live zu konfigurieren. Führen Sie diese Aktion für beide Umgebungen aus.

Geben Sie Folgendes in die Tabelle ein:

• Öffnen Sie den Tab „Dienste“. Klicken Sie auf worldline.https.direct.yourSiteId und geben Sie Folgendes in die Tabelle ein:

Führen Sie diese Aktion für beide Umgebungen aus.

Merchant ID, Data Locale und Betriebscode erstellen

Jede Transaktion wird auf unsere Plattform über eine Test-/Live-PSPID kanalisiert. Sie müssen auch festlegen, ob unsere Plattform Transaktionen über Autorisierungen oder im Direktverkaufsmodus verarbeiten soll. Wenn die Muttersprache Ihrer Kunden nicht Englisch ist, müssen Sie über das Locale auch die Sprache der Zahlungsseite bestimmen.

• Gehen Sie zu Merchant Tools > Site Präferenzen > Benutzerdefinierte Präferenzen. Klicken Sie auf „WORLDLINE_DIRECT“ in der Spalte „ID“, um Ihre allgemeine Konfiguration zu erstellen, damitIhr Store mit unserer Plattform verbunden werden kann. Führen Sie die Aktionen so aus, wie in der Tabelle erläutert:
  
  

• Geben Sie die folgenden Daten auf der Site ein:

Zahlungsarten und Integrationsmodi konfigurieren

Wir teilen Zahlungsarten in zwei unterschiedliche Cluster auf:

• Kartenzahlungen und
• Alternative Zahlungsarten

Sie können Kartenzahlungen entweder via Hosted Tokenization Page oder Hosted Checkout Page verarbeiten, während die alternativen Zahlungsarten nur via Hosted Checkout Page verfügbar sind.

Führen Sie diese Schritte aus, um zu wählen:

• Gehen Sie zu Merchant Tools > Beauftragung > Zahlungsmethoden. Klicken Sie auf „WORLDLINE_DIRECT_CARD“ oder „WORLDLINE_DIRECT_REDIRECT“ in Spalte „ID“. Wählen Sie „JA“ für aktiviert. Führen Sie die Aktionen so aus, wie in der Tabelle erläutert:

• Gehen Sie zu Merchant Tools > Site Präferenzen > Benutzerdefinierte Präferenzen. Klicken Sie auf eine davon in der Spalte „ID“, um sie zu konfigurieren und anzupassen.

.

Webhooks konfigurieren

Das Plugin nutzt Webhooks, um den aktuellen Status Ihrer Transaktionen von unserer Plattform abzurufen. So ist Ihre Store-Datenbank stets aktuell.

• Konfigurieren Sie einen WebhooksKey, ein WebhooksKeySecret und Endpunkt-URLs in Ihrer PSPID, so wie in unserer Anleitung beschrieben. Verwenden Sie dabei die folgende Formel für Ihre Endpunkt-URLs:
  https://{domain}/on/demandware.store/Sites-{yourSiteId}-Site/{locale}/WorldlineDirect-Webhooks
• Gehen Sie zu Merchant Tools > Site Präferenzen > Benutzerdefinierte Präferenzen. Klicken Sie auf „WORLDLINE_DIRECT_WEBHOOKS“ in der Spalte „ID“. Führen Sie die Aktionen so aus, wie in der Tabelle erläutert:

• Gehen Sie zu Verwaltung > Operationen > Jobs. Klicken Sie in der Liste auf „WorldlineProcessWebhooks“. Gehen Sie zu Job Step, um den Umfang für Ihre Site festzulegen. Konfigurieren Sie den Plan für den Job auf der Grundlage Ihrer Bedürfnisse.

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 Merchant Tools > Beauftragung > Worldline-Direct-Transaktionen. Klicken Sie auf die Schaltfläche „Test-API-Verbindung“. Überprüfen Sie, ob dann eine Dialogbox erscheint mit dem Text „Verbindung zur Worldline-Direct-API erfolgreich“

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.

Follow-up von Bestellungen, Status der Zahlung überprüfen / Nicht bestätigte Bestellungen verarbeiten

Um sicherzustellen, dass

• Ihre Plattform erfolgreiche Zahlungen (StatusCode=5 oder 9 und Status=”PAYMENT_CREATED”) als solche registriert und nicht als nicht beendet (wegen einer fehlgeschlagenen Umleitung Ihrer Kunden auf die Salesforce Commerce Cloud Website)
• werden autorisierte Transaktionen durch eine Erfassung abgeschlossen. (Wenn Sie den Betriebscode: Autorisierung bei der Erstbestellung wählen.)

Das Plugin implementiert den „Statusjob Zahlung überprüfen“. Führen Sie diese Schritte aus, damit es funktioniert:

• Ändern Sie das Merkmal cancelUnconfirmedOrderAfterHours auf die erwünschte Anzahl von Stunden ab, nach deren Ablauf das Plugin eine schwebende Bestellung storniert.
• Finden Sie heraus, wie Autorisierungen automatisch oder manuell erfasst werden können.

Autorisierung automatisch erfassen

Wenn Sie sich dazu entscheiden, Transaktionen nur bei der Erstbestellung zu autorisieren, dann erfasst das Plugin diese für Sie zu einem späteren Zeitpunkt. Sie können die Intervalle und den Zeitpunkt für die Erfassung auf der Grundlage Ihrer geschäftlichen Anforderungen festlegen.

Gehen Sie zu Verwaltung > Jobs > WorldlineCaptureAuthorizedPayments > Plan und Historie. Führen Sie die Aktionen so aus, wie in der Tabelle für den entsprechenden Erfassungsmodus festgelegt:

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 Business Manager ausführen.

Gehen Sie zu Merchant Tools > Beauftragung > Worldline-Direct-Transaktionen. Rufen Sie die fragliche Transaktion auf und klicken Sie in der Spalte „Kategorie“ auf „Details“. Die Dialogbox zeigt die möglichen Aktionen an, die Sie in Bezug auf eine Transaktion ausführen können. Führen Sie für die entsprechenden Wartungsmaßnahmen die Aktionen so durch, wie in der Tabelle dargelegt.

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.