Salesforce Commerce Cloud

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

Une fois fait, suivez ces étapes :

1. Installer la cartouche
   Installez la cartouche dans le répertoire racine de votre projet au même niveau que storefront-reference-architecture. Voici un exemple de la structure des dossiers :
   

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

1. Installer les modules Node
   La version recommandée de Node à utiliser est la 12.21.0. Depuis le repository racine de la cartouche, installez les modules Node en utilisant votre ligne de commande :

   
   npm install
   
   

2. Compiler le code
   Depuis le repository racine de la cartouche, compilez les ressources côté client en utilisant votre ligne de commande :

   
   npm run build
   
   

3. Télécharger le code
   Téléchargez int_worldline_direct et bm_worldline_direct en utilisant Commerce Cloud UX Studio ou
   les utilitaires de ligne de commande sgmf-scripts.
   
   
4. Importer les métadonnées
   Pour ajouter de nouveaux éléments de configuration, importez les métadonnées prédéfinies en suivant ces étapes :
   • Ouvrez le dossier /metadata/site_import/sites/.
   • Renommez le dossier yourSiteId avec l'ID de votre site dans le Business Manager.
   • Zipez le dossier site_import.
   • Dans le Business Manager, allez à Administration > Site Development > Site Import & Export et importez le fichier zippé.
   
   
   Après l'importation, les attributs nommés WorldlineDirect[attributeName] sont ajoutés à Administration > Site Development.
   
   System Object Types > Site Preferences > Attribute Definitions
   System Object Types > Order > Attribute Definitions
   System Object Types > OrderPaymentInstrument > Attribute Definitions
   System Object Types > CustomerPaymentInstrument > Attribute Definitions
   Custom Object Types
   
   Le service worldline.https.direct.yourSiteId est ajouté à Administration > Operations > Services.

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

Connectez-vous au Business Manager. Définissez les valeurs suivantes dans les menus et confirmez en cliquant sur "Appliquer" ou "Enregistrer" :

Définir les chemins des cartouches

Pour intégrer un module externe et le lier avec le Business Manager, suivez ces étapes :

• • Allez dans Administration > Sites > Gérer les sites > [votreSite] > Paramètres. Entrez ce qui suit dans "Cartouches" :
    
    

    int_worldline_direct:app_storefront_base

• • Allez dans Administration > Sites > Gérer les sites > Gérer le site Business Manager > Paramètres. Entrez ce qui suit devant toute autre cartouche existante :
    
    

    bm_worldline_direct:int_worldline_direct:bm_app_storefront_base:bm_custom_plugin

Définir les autorisations du Business Manager

Gérez les droits d'accès du module pour assurer une interaction correcte avec votre Business Manager et vos vitrines :

• • Allez dans Administration > Organisation > Rôles et autorisations. Cliquez sur le rôle que vous souhaitez mettre à jour dans le tableau. Allez dans Modules du Business Manager.
  • Dans la fenêtre contextuelle "Sélectionner le contexte", sélectionnez tous les sites de vitrine qui utiliseront la cartouche de paiements Worldline-Direct.
  • Trouvez le module Ordering dans le tableau des modules. Attribuez les permissions des modules Transactions Directes Worldline et Abonnements Directs Worldline pour le rôle sélectionné.

Configurer les identifiants pour l'environnement de Test/Production

Pour cibler notre environnement de test/production et vous assurer que vos requêtes sont légitimes, vous devez configurer les API endpoints URL et une paire clé secrète/API liée à un PSPID spécifique.

• Allez dans Administration > Opérations > Services. Ouvrez l'onglet "Identifiants".
• Cliquez sur worldline.https.direct.yourSiteId.TEST dans la colonne "Nom" du tableau pour configurer soit test/production. Effectuez l'action pour les deux environnements.

• Entrez ce qui suit dans le tableau :

• Ouvrez l'onglet Services. Cliquez sur worldline.https.direct.yourSiteId et entrez ce qui suit dans le tableau :

Effectuez l'action pour les deux environnements.

Configurer Worldline-Direct Payments Cartridge

Chaque transaction est acheminée via un PSPID test/production sur notre plateforme.

• Allez dans Outils Marchand > Préférences du site > Préférences personnalisées. Effectuez les actions pour chacun des groupes personnalisés comme indiqué dans le tableau ci-dessous :

WORLDLINE_DIRECT (Shared Config)

WORLDLINE_DIRECT_HCP (Hosted Checkout Page Settings)

WORLDLINE_DIRECT_HTP (Hosted Tokenization Page Settings)

WORLDLINE_DIRECT_WEBHOOKS (Webhooks config)

WORLDLINE_DIRECT_3DS (3-D Secure config)

Configure payment methods and integration modes

We categorise payment methods into two different clusters:

• Card payments
• Alternative payment methods

You can process card payments either via Hosted Tokenization Page or Hosted Checkout Page, whereas the alternative payment methods are available only via Hosted Checkout Page.

Follow these steps to make your choice:

• Go to Merchant tools > Ordering > Payment methods. Click on either “WORLDLINE_DIRECT_CARD”/”WORLDLINE_DIRECT_REDIRECT” in column “ID”. Make sure to select YES for enabled. Perform the actions as stated in the table:

Configurations supplémentaires

1. Abonnements

L'option Abonnements Worldline-Direct permet au client de commander un ensemble spécifique de produits dans la boutique en ligne à intervalles réguliers. Les intervalles peuvent être gérés via le plugin.

Cette fonctionnalité est disponible uniquement pour les clients enregistrés. Veuillez suivre les étapes suivantes pour l'activer :

• Activer les abonnements via Outils du commerçant > Préférences du site > Préférences personnalisées.
• Accédez à Administration > Opérations et ouvrez l'onglet Identifiants pour configurer les informations d'identification du service. Ouvrez worldline.httpform.ocapi et modifiez :
  
  • URL : ajoutez l'URL de votre site/instance
  • Utilisateur : saisissez votre ID de clé API.
  • Mot de passe : saisissez le secret de votre clé API.
• Cliquez sur Appliquer.
• Configurez les services en naviguant vers l'onglet Services.
  
  • Sélectionnez les identifiants httpform.ocapi.
  • Choisissez un profil pour la requête OCAPI (en créer un si aucun n'existe) et appliquez.

Configurer les webhooks

Le plugin utilise les webhooks pour obtenir le statut actuel de vos transactions depuis notre plateforme. De cette façon, la base de données de votre boutique est toujours à jour.

• Configurez une WebhooksKey, un WebhooksKeySecret et des URL Endpoint dans votre PSPID comme décrit dans notre guide dédié. Assurez-vous d'utiliser la formule suivante pour vos URL Endpoint :
  https://{domaine}/on/demandware.store/Sites-{votreIdSite}-Site/{locale}/WorldlineDirect-Webhooks
• Allez dans Outils Marchand > Préférences du site > Préférences personnalisées. Cliquez sur “WORLDLINE_DIRECT_WEBHOOKS” dans la colonne “ID”. Effectuez les actions indiquées dans le tableau :

• Allez dans Administration > Opérations > Jobs. Cliquez sur “WorldlineProcessWebhooks” dans la liste. Allez à Job Step pour définir le périmètre sur votre site. Configurez le calendrier pour le job en fonction de vos besoins.

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 Outils Marchand > Commandes > Transactions Worldline-Direct. Cliquez sur le bouton “Tester la connexion API”. Vérifiez que la boîte de dialogue affichée indique “Connexion à l'API Worldline-Direct réussie”.

Nous avons conçu le plugin pour assurer le suivi de 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 !

Suivi des commandes Vérifier le statut du paiement / Traiter les commandes non confirmées

Pour vous assurer que

• votre plateforme enregistre les paiements réussis (StatusCode=5 ou 9 et Status="PAYMENT_CREATED") comme tels et non comme non terminés (en raison d'une redirection échouée de vos clients vers le site Salesforce Commerce Cloud).
• les transactions autorisées sont finalisées par une capture (si vous choisissez Code d'Opération : Autorisation lors de la commande initiale).

le plugin implémente le "Check payment status job". Suivez ces étapes pour les faire fonctionner :

• Modifiez la propriété cancelUnconfirmedOrderAfterHours au nombre d'heures souhaité après lequel le plugin annule une commande en statut attente.
• Découvrez comment capturer les autorisations automatiquement ou manuellement.

Capture automatique de l'autorisation

Si vous choisissez d'autoriser les transactions uniquement lors de la commande initiale, notre plugin les capturera pour vous à un moment ultérieur. Vous pouvez définir les intervalles et le moment des captures en fonction de vos besoins commerciaux.

Allez dans Administration > Travaux > WorldlineCaptureAuthorizedPayments > Calendrier et Historique. Effectuez les actions indiquées dans le tableau pour le mode de capture respectif :

Effectuer des opérations de maintenance

Les captures, remboursements et annulations d'autorisations sont des processus standard (également connus sous le nom d'opérations de maintenance) dans votre logique métier quotidienne. Apprenez ici comment effectuer ces opérations dans le Business Manager :

Allez dans Outils Marchand > Commandes > Transactions Worldline-Direct. Recherchez la transaction en question et cliquez sur "Détails" dans la colonne "Catégorie". La boîte de dialogue affiche les actions possibles que vous pouvez effectuer sur une transaction. Effectuez l'action indiquée dans le tableau pour réaliser les opérations de maintenance correspondantes.

This is an example of the user interface. The available currencies depend on your configuration, region and transaction context.

Abonnements

Gérer les commandes d'abonnement n'a jamais été aussi simple ! Tout comme les paiements ponctuels, les commandes d'abonnement peuvent être gérées via le gestionnaire d'entreprise.

• Accédez à Outils du commerçant > Commandes > Abonnements Worldline-Direct pour accéder au module. Cette page liste les commandes d'abonnement avec leurs détails.
• Cliquez sur la commande pour vérifier les détails de l'abonnement comme la période et la fréquence. Vous pourrez bloquer/débloquer ou annuler un abonnement via la même page.

Veuillez noter que l'abonnement au blocage est un statut temporaire en cas de rupture de stock ou de problèmes de paiement. Ce statut est reversible et peut être modifié manuellement une fois les problèmes résolus.

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

Vous avez une demande de nouvelle fonctionnalité ?

Accédez à Outils du commerçant > Commande > Transactions Directes Worldline. Vous trouverez l'option en bas de la page.