SAP Commerce Cloud

La première étape pour utiliser le plugin est le processus d'installation. Avant de procéder, assurez-vous que votre infrastructure respecte ces exigences système :

En plus de ces prérequis, assurez-vous de respecter la structure d'extension :

Une fois terminé, suivez ces étapes :

1. Installez SAP Commerce en utilisant la recette ‘cx’

SAP fournit des instructions pour utiliser les recettes d'installation dans le Portail d’aide SAP. Si vous ne connaissez pas le processus d'installation général, assurez-vous de le lire avant l'installation.

• Téléchargez SAP Commerce au format .Zip. Décompressez la plateforme et accédez au repository 'installer'.
• Exécutez la commande suivante : Remplacez 'your_password' par votre mot de passe d'administrateur souhaité pour le système.

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

• Exécutez la commande suivante pour construire et initialiser le système :

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

• Ajouter des extensions à la base de code
  Téléchargez et décompressez le fichier
  Confirmez que vous avez reçu la structure de repositories suivante

hybris/
           config/
           bin/
                       custom/
                                     worldline/

• Le repository de configuration contient un ensemble d'exemples de configurations dans le fichier local.properties. Copiez ces configurations dans le fichier local.properties généré après l'installation de SAP Commerce.
• Le repository de configuration contient également un fichier localextensions.xml. Ajoutez ce qui suit de ce fichier à votre propre fichier localextensions.xml qui a été généré après l'installation de SAP Commerce :

<!-- 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"/>

• Le repository bin/custom/worldline contient toutes les extensions requises. Copiez-les dans votre propre repository hybris/bin/custom/worldline. Si vous souhaitez placer ces extensions dans un repository différent, mettez à jour votre localextensions.xml en conséquence.

2. Installer l'extension sur la vitrine

• Vous devrez peut-être exécuter la commande suivante pour vous assurer que les addons corrects sont disponibles dans votre vitrine :

  
   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>"

  

Remplacez <YOUR-STOREFRONT> par le nom de l'extension de votre vitrine, par exemple yacceleratorstorefront ou <project>storefront

• Installez l'Addon sur votre vitrine, utilisez la commande suivante :

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

• Rebâtissez maintenant votre système :

ant clean all

• Effectuez une initialisation ou une mise à jour du système. Vous pouvez faire les deux via la Console d'administration Hybris (HAC) à l'adresse https://<votre-serveur>:9002/hac ou vous pouvez initialiser cela via la cible ant :

ant initialize

Après l'installation, vous devez configurer le plugin pour lier votre boutique à notre plateforme.

Cette section de la documentation couvrira uniquement les éléments de configuration technique. Pour la configuration commerciale au sein du Backoffice SAP, consultez cette section.

Configurer les propriétés

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

Le SDK Java transmet ces configurations et contrôle la connectivité. Consultez notre documentation dédiée au SDK Java pour plus d'informations.

• Depuis worldlinedirectbackoffice/project.properties :

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

Ces configurations contrôlent le bouton dans le Back Office SAP utilisé pour nous contacter pour un support par e-mail.

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

Ces configurations définissent la valeur de la propriété HostedCheckoutSpecificInput.ReturnUrl de l'API Server pour garantir la redirection correcte de vos clients vers votre environnement de boutique en ligne. Il est important de mettre à jour ces valeurs pour refléter l'URL de votre système.

Configurer les Webhooks

Le plugin utilise des webhooks pour obtenir le statut actuel de vos transactions depuis notre plateforme. SAP Commerce utilise le API endpoint /worldline/webhook pour recevoir ces mises à jour de statut.

Configurez une WebhooksKey, un WebhooksKeySecret et les URLs des points de terminaison dans votre PSPID comme décrit dans notre guide dédié. Assurez-vous que l'URL :

• Contient le nom d'hôte de votre site '(i.e. https://<your-domain>:9002/worldline/webhook)'
• Dispose d'un certificat SSL valide

Configurer SAP

Les étapes suivantes couvrent le processus de configuration de l'outil SAP Commerce Backoffice. Pour des informations générales sur le SAP Commerce Backoffice, veuillez vous référer aux guides de l'utilisateur professionnel dans le Portail d'aide SAP.

Après une installation réussie, le Backoffice SAP contient un nouveau type d'élément « Configuration Worldline ». Suivez ces étapes pour lier votre Base Store dans SAP Commerce à notre plateforme :

• Connectez-vous au Backoffice SAP Commerce via l'URL par défaut https://<hostname>:9002/backoffice. Les identifiants administrateur par défaut auront été définis lors de l'installation ou vous auront été fournis séparément.

Allez dans Worldline > Configuration Worldline. Cliquez sur le symbole « + » dans la barre des tâches.

Entrez les informations suivantes à partir du tableau dans la fenêtre contextuelle qui s'affiche :

Cliquez sur « TERMINÉ » pour confirmer votre configuration

• Cliquez sur le profil de configuration dans le tableau que vous venez de confirmer. Entrez les informations suivantes à partir de la vue d'ensemble du tableau :

Cliquez sur « ENREGISTRER » pour confirmer votre configuration.

Configurer la boutique de base

Avant de commencer à traiter des transactions (tests), vous devez

• Lier vos boutiques de base à la configuration du plugin.
• Sélectionner un mode d'intégration.

Pour ce faire, suivez ces étapes et confirmez en cliquant sur "ENREGISTRER" dans chaque onglet :

• Accédez à Base Commerce > Base Store. Sélectionnez le magasin dans le tableau avec les en-têtes "ID" / "Nom".

Sélectionnez "Worldline" parmi les onglets disponibles et faites défiler jusqu'à "CONFIGURATION WORLDLINE".

• Entrez les informations suivantes à partir de la vue d'ensemble du tableau :

• Sélectionnez "ADMINISTRATION" dans les onglets disponibles et faites défiler jusqu'à "UNBOUND". Entrez "worldlineB2CResponsiveCheckoutGroup" dans le champ "Groupe de flux de passage en caisse"
  
• Sélectionnez "PROPRIÉTÉS" dans les onglets disponibles et faites défiler jusqu'à "FOURNISSEUR DE PAIEMENT". Entrez "Worldline" dans le champ "Fournisseur de paiement"

Tester la connexion

Une fois que vous avez terminé toutes les étapes, vérifiez la configuration en établissant une connexion de test entre le plugin et notre plateforme :

• Allez dans Worldline > Configuration Worldline. Sélectionnez le profil de configuration dans le tableau avec les en-têtes "ID du marchand" / "API Key".
• Cliquez sur "Test de connexion" dans la vue d'ensemble du profil de configuration. Vérifiez que la fenêtre contextuelle indique "OK (succès)". Si la fenêtre contextuelle indique un échec du test, contactez votre administrateur système pour résoudre le problème.

Configurer les modes de paiement

Pour configurer la liste des modes de paiement, allez dans Paramètres des prix > Modes de paiement. 

Cette liste affiche toutes les méthodes de paiement disponibles dans votre système. (Dé)sactivez toute méthode de paiement en définissant le drapeau "Est actif" en conséquence. Une fois qu'une nouvelle méthode de paiement a été ajoutée à votre compte Worldline, vous devrez peut-être l'ajouter manuellement. Pour ce faire, cliquez sur le bouton "+" en haut de la liste. 

Configurer Card On File

Pour configurer Card On File, allez dans Worldline > Token récurrent Worldline. 

Cette liste affiche tous les tokens pour Card On File disponibles dans votre système. Cliquez sur la ligne respective dans le tableau pour obtenir un aperçu complet du token individuel et des actions possibles : 

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: 

Nous avons conçu le plugin pour suivre vos commandes automatiquement et de manière autonome, vous libérant ainsi de l'administration impliquée. Apprenez ici comment utiliser notre plugin efficacement, ce qui pourrait aider votre entreprise à prospérer !

Effectuer des opérations de maintenance

Les captures, remboursements et annulations d'autorisations sont des processus standard (également appelés opérations de maintenance) dans votre logique métier quotidienne. Apprenez ici comment effectuer ces opérations dans le Backoffice SAP.

Effectuer des transactions de test

Utilisez l'environnement de test de notre plateforme pour vous assurer que votre plugin fonctionne comme prévu. Nous proposons des ensembles de données de test sur notre page dédiée Cas de test. Ciblez notre environnement de test comme décrit dans la section "Configurer le plugin".