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 l'ID Marchand, le format régional des données et le code d'opération

Chaque transaction est acheminée via un PSPID test/production sur notre plateforme. Vous devez également définir si notre plateforme traite les transactions en mode autorisation ou en Direct Sale. Si la langue maternelle de vos clients est différente de l'anglais, vous devez également définir la langue des pages de paiement via le paramètre régional.

• Allez dans Outils Marchand > Préférences du site > Préférences personnalisées. Cliquez sur "WORLDLINE_DIRECT" dans la colonne "ID" pour configurer votre configuration générale afin de connecter votre boutique à notre plateforme. Effectuez les actions indiquées dans le tableau :

• Entrez les données suivantes sur le site :

Configurer les méthodes de paiement et les modes d'intégration

Nous classons les méthodes de paiement en deux catégories différentes :

• Paiements par carte
• Méthodes de paiement alternatives

Vous pouvez traiter les paiements par carte soit via Hosted Tokenization Page ou Hosted Checkout Page, tandis que les méthodes de paiement alternatives ne sont disponibles que via Hosted Checkout Page.

Suivez ces étapes pour faire votre choix :

• Allez dans Outils Marchand > Commandes > Méthodes de paiement. Cliquez soit sur “WORLDLINE_DIRECT_CARD”/”WORLDLINE_DIRECT_REDIRECT” dans la colonne “ID”. Assurez-vous de sélectionner OUI pour activé. Effectuez les actions indiquées dans le tableau :

• Allez dans Outils Marchand > Préférences du site > Préférences personnalisées. Cliquez sur l'une des options dans la colonne "ID" pour les configurer et les personnaliser.

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.

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