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"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectb2ccheckoutaddon"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectb2bcheckoutaddon"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectbackoffice"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectocc"/>
<extension dir="${HYBRIS_BIN_DIR}/custom/worldline/worldlinedirectwebhook"/>

• 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

• Pour exécuter les commandes ant ci-dessous, vous devrez exécuter . ./setantenv.sh ou son équivalent Windows dans le repository hybris/bin/platform.
• 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,assist
edservicepromotionaddon,assistedservicestorefront,assistedserviceyprofileaddon,captch
aaddon,configurablebundleaddon,consignmenttrackingaddon,customercouponaddon,customerc
ouponsamplesaddon,customerinterestsaddon,customerticketingaddon,eventtrackingwsaddon,
merchandisingaddon,merchandisingstorefrontsampledataaddon,multicountrysampledataaddon
,notificationaddon,ordermanagementaddon,orderselfserviceaddon,pcmbackofficesamplesadd
on,personalizationaddon,personalizationsampledataaddon,personalizationyprofilesampled
ataaddon,profiletagaddon,selectivecartsplitlistaddon,smarteditaddon,stocknotification
addon,textfieldconfiguratortemplateaddon,timedaccesspromotionengineaddon,timedaccessp
romotionenginesamplesaddon,xyformssamples,xyformsstorefrontcommons,ysapproductconfiga
ddon" -DaddonStorefront.yacceleratorstorefront=""

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

• Utilisez la commande suivante pour installer l'addon B2B sur votre boutique en ligne :

ant addoninstall -Daddonnames="worldlinedirectb2bcheckoutaddon" 
-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. 

Veuillez noter que l'API Worldline impose une limite de 50 caractères pour le champ adresse e-mail du client, alors que la plateforme SAP Commerce Cloud et le plugin ne le font pas. N'oubliez donc pas de valider ce champ pour qu'il respecte cette limite.

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.

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 Backoffice

Les étapes suivantes couvrent le processus de configuration du Backoffice SAP Commerce. 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 « Fin » pour confirmer votre configuration.

Sélectionnez une configuration dans la liste des configurations existantes pour la modifier. Ouvrez-la, et l'éditeur apparaîtra en bas de l'écran. N'oubliez pas d'enregistrer les configurations mises à jour.

Test de connexion

Une fois ces étapes terminées, vérifiez la configuration en établissant une connexion de test entre le plugin et notre plateforme :

Les marchands peuvent désormais partager leurs retours ou demander des fonctionnalités supplémentaires via le bouton « Demander une nouvelle fonctionnalité » dans le plugin.

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 :

Worldline Tab

Configurations 3D Secure (3DS tab)

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 une méthode 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"

Configurer les modes de paiement

Pour configurer cette liste de modes de paiement dans SAP Commerce, accédez au menu suivant dans le Backoffice :

Une fois que vous cliquez sur Modes de Paiement, vous verrez une liste des Modes de Paiement actuellement chargés dans le système. Après avoir sélectionné un Mode de Paiement, vous pouvez l'activer ou le désactiver en modifiant le flag isActive.

Si vous ajoutez un nouveau mode de paiement à votre compte dans le Backoffice de ANZ Worldline Payment Solutions, il se peut que vous deviez l'ajouter manuellement au système en cliquant sur le bouton '+' en haut de la liste des modes de paiement.

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 : 

Vous pouvez bloquer ou débloquer n'importe quel token récurrent depuis cette page selon vos besoins.

Commandes de réapprovisionnement

Les vitrines B2B et B2C ont toutes deux accès à la fonctionnalité de commandes de réapprovisionnement. Plusieurs configurations doivent être définies afin de la personnaliser, comme expliqué dans les sections précédentes.

Les commandes de réapprovisionnement sont créées à l'aide d'une tâche cron (cronjob). Les propriétés suivantes sont requises pour les processus de commande de réapprovisionnement :

• Panier – Sert de modèle pour la commande de réapprovisionnement.
• Commandes – Liste des commandes créées à partir des données du panier. La première commande est celle passée manuellement par le client lors du processus de paiement (checkout). Toutes les commandes suivantes sont créées automatiquement par la tâche cron.
• Entrées d'historique des CronJobs – Conservent les informations relatives aux exécutions des tâches cron.
• Informations de paiement – Informations de paiement utilisées pour les appels serveur à serveur vers ANZ Worldline Payment Solutions afin de traiter les paiements des commandes ultérieures.
• Soumis – Cette propriété indique qu'aucun problème n'est survenu lors de la création de la tâche cron. Si sa valeur est définie sur false, aucune commande future ne sera créée.

Vous trouverez toutes les configurations et tous les processus détaillés dans le guide README fourni avec le package du plugin.

Nous avons conçu le plugin pour suivre vos commandes de manière automatique et autonome, vous libérant de la gestion administrative impliquée. Apprenez ici comment utiliser efficacement notre plugin, 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 commerciale quotidienne. Vous pouvez effectuer ces opérations sur une transaction en utilisant le Backoffice support client.

Une fois connecté au Backoffice support client, toutes les commandes seront listées dans la section Commandes. Vous pouvez sélectionner la commande sur laquelle vous souhaitez effectuer des opérations de maintenance.

Vous pouvez effectuer des actions telles que capturer ou annuler des paiements à partir des options disponibles en haut de la section détails de la commande. Annuler une commande entraînera une demande de remboursement ou une annulation d'autorisation lorsque cela est applicable.

Gérer les tokens récurrents

Les opérations de maintenance vous permettent également de gérer les tokens récurrents. Vous pouvez les bloquer, les débloquer ou les révoquer.

Gestion des mandats

Vous pouvez gérer le statut des mandats via les actions suivantes : Bloquer, Débloquer ou Révoquer.

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