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_gopay/
   |  |-- cartridges/
   |  |  |-- bm_worldline_gopay/
   |  |  |-- int_worldline_gopay/
   |  |-- documentation/
   |  |-- metadata/
   |-- storefront-reference-architecture
   |  |-- cartridges/
   |  |  |-- app_storefront_base/
   |  |  |-- modules/
   

   Si vous avez renommé le dossier storefront-reference-architecture, assurez-vous de mettre à jour le chemin de base dans package.json.

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

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

4. Télécharger le code
   Téléchargez int_worldline_gopay et int_worldline_gopay_sfra en utilisant Commerce Cloud UX Studio ou
   les utilitaires de ligne de commande sgmf-scripts.

5. 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 WorldlineGoPay[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.gopay.yourSiteId est ajouté à Administration > Operations > Services.

   Mises à niveau depuis les versions précédentes

   La version v26.3.0 du plugin introduit une refactorisation majeure ainsi qu'un changement de marque du cartridge vers Worldline GoPay. Dans le cadre de ce changement, nous avons renommé le code du cartridge, les attributs de métadonnées, les services, la configuration des paiements et d'autres composants qui utilisaient la convention de nommage worldlineDirect. Ils utilisent désormais la nouvelle convention de nommage.

   worldlineGoPay
   Les commandes existantes et les moyens de paiement des clients peuvent encore contenir des données dans les anciens attributs. La mise à niveau inclut donc une tâche de migration. Cette tâche copie les données pertinentes des anciens attributs vers les nouveaux attributs worldlineGoPay.

   Suivez ces étapes :

   1. Remplacez les cartridges existants
      
      • Supprimez :
        int_wordline_direct
        bm_worldline_direct
        
        
      • Ajoutez :
        int_worldline_gopay_sfra
        int_worldline_gopay
        bm_worldline_gopay
        
        Mettez à jour les chemins des cartridges pour le ou les sites concernés ainsi que la configuration de Business Manager, partout où cela est nécessaire.
        
        
   2. Importez les métadonnées Worldline GoPay
      Importez les métadonnées à l'aide du processus d'import standard décrit dans la section Installation.
      L'import crée la nouvelle configuration Worldline GoPay y compris les éléments requis suivants :
      
      • Attributs des objets système
      • Types d'objets personnalisés
      • Services, profils et identifiants
      • Tâches
      • Moyens de paiement
      • Processeurs de paiement
      • Préférences du site
      • Autres métadonnées du cartridge incluses dans le package
        
        
   3. Configurez et exécutez la tâche de migration
      Créez et configurez une nouvelle tâche sous Administration > Operations > Jobs. Ajoutez une job step en utilisant la nouvelle step créée : custom.worldlineGoPayRebrandingJob et configurez les paramètres suivants :
      migrateOrder – indique s'il faut migrer les données Worldline stockées dans les commandes existantes.
      migrateCustomerSavedInstruments – indique s'il faut migrer les tokens client enregistrés existants.
      
      Exécutez la tâche de migration après l'importation des nouvelles métadonnées. Selon les paramètres configurés, la tâche de migration migrera les informations pertinentes pour :
      Les commandes existantes
      Les moyens de paiement client existants
      
      
   4. Supprimez les anciennes métadonnées
      Les métadonnées présentes peuvent varier selon la version du cartridge précédemment installée. Supprimez toutes les configurations obsolètes associées à Worldline Direct / worldlineDirect.
      
      a) Administration > Operations > Services
      Supprimez tous les éléments Worldline Direct obsolètes :
      Services
      Profiles
      Credentials
      
      b) Administration > Operations > Jobs
      Examinez les tâches Worldline existantes et remplacez toutes les étapes de tâche Worldline Direct obsolètes par les étapes de tâche Worldline GoPay correspondantes. Assurez-vous également que les paramètres de tâche associés sont mis à jour si nécessaire.
      
      c) Administration > Site Development > Custom Object Types
      Supprimez les types d’objets personnalisés Worldline Direct obsolètes :
      WorldlineDirectPaymentProducts
      WorldlineDirectWebhooks
      
      d) Administration > Site Development > System Object Types
      Supprimez les attributs et groupes d’attributs worldlineDirect obsolètes des types d’objets système concernés dans :
      CustomerPaymentInstrument
      OrderPaymentInstrument
      Order
      SitePreferences
      
      e) Merchant Tools > Payment Methods
      Supprimez les moyens de paiement obsolètes associés à Worldline Direct :
      WORLDLINE_DIRECT_CARD
      WORLDLINE_DIRECT_REDIRECT
      WORLDLINE_DIRECT_CREDIT_REDIRECT
      WORLDLINE_DIRECT_DIRECTDEBIT
      
      f) Merchant Tools > Payment Processors
      Supprimez les processeurs de paiement obsolètes associés à Worldline Direct :
      WORLDLINE_DIRECT_CARD
      WORLDLINE_DIRECT_REDIRECT
      WORLDLINE_DIRECT_CREDIT_REDIRECT
      WORLDLINE_DIRECT_DIRECTDEBIT
      
      
   5. Configurez le nouveau cartridge conformément aux instructions données dans la section "Configuration".
      
      
   6. Vérifiez la mise à niveau en contrôlant que
      a) Les services Worldline GoPay sont configurés et opérationnels.
      b) Les commandes existantes migrées contiennent les données Worldline GoPay.
      c) Les moyens de paiement client existants contiennent les données migrées.
      d) Les nouvelles commandes renseignent les attributs worldlineGoPay plutôt que les attributs obsolètes worldlineDirect.
      e) Tous les moyens de paiement pris en charge peuvent être utilisés avec succès lors du paiement.
      f) Les flux d'autorisation, de capture, d'annulation et de remboursement fonctionnent comme prévu, le cas échéant.
      g) Les tâches planifiées s'exécutent avec succès.
      h) Il ne reste aucune dépendance à l'exécution sur des métadonnées obsolètes.

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_gopay_sfra:int_worldline_gopay: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_gopay:int_worldline_gopay: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-GoPay.
  • Trouvez le module Ordering dans le tableau des modules. Attribuez les permissions des modules Transactions Worldline-GoPay et Worldline-GoPay Abonnements 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.gopay.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.gopay.yourSiteId et entrez ce qui suit dans le tableau :

Effectuez l'action pour les deux environnements.

Configurer Worldline-GoPay 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_GOPAY (Configuration partagée)

Cliquez sur "Enregistrer" dans le coin supérieur droit de l'écran.

WORLDLINE_DIRECT_3DS (Configuration 3-D Secure)

WORLDLINE_GOPAY_HCP (Paramètres de la Hosted Checkout Page)

WORLDLINE_DIRECT_HTP (Paramètres de la Hosted Tokenization Page)

WORLDLINE_DIRECT_WEBHOOKS (Configuration des webhooks)

WORLDLINE_GOPAY_MOBILE (Mobile Payments)

Configurer les méthodes de paiement et les méthodes 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 sur la méthode de paiement pertinente. Assurez-vous de sélectionner OUI pour activé. Assurez-vous de sélectionner OUI pour activé. Effectuez les actions indiquées dans le tableau :

Vous pouvez également récupérer, visualiser ou masquer, personnaliser et trier tous les modes de paiement disponibles sur votre compte Worldline dans le Business Manager. Naviguez vers Outils pour marchands > Commande > Produits de Paiement Direct Worldline pour voir tous les modes de paiement disponibles sur votre compte Worldline. Actualisez la liste chaque fois que vous activez de nouveaux modes de paiement sur votre compte pour la mettre à jour. Depuis cette page, vous pouvez également masquer des modes de paiement si vous ne souhaitez pas qu'ils soient disponibles sur la page de paiement.

Configurations supplémentaires

1. Mealvouchers

Notre plugin prend en charge le moyen de paiement Mealvouchers. Pour le rendre disponible, le cartridge ajoute un attribut personnalisé à l’objet Produit : Mealvouchers product type, avec les valeurs suivantes :

• FoodAndDrink - Articles alimentaires et de boisson éligibles aux chèques repas
• HomeAndGarden - Articles pour la maison et le jardin généralement éligibles aux chèques écologiques
• GiftAndFlowers - Articles cadeaux et fleurs potentiellement éligibles aux chèques écologiques et à un autre type de bon (Chèques Cadeau)

Configurez ce champ par produit en l'incluant dans votre flux de produits vers Salesforce Commerce Cloud ou en modifiant manuellement les produits dans Business Manager.

2. Abonnements

L'option Abonnements Worldline-GoPay 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 :

Activez les abonnements en navigant vers Merchant tools > Site Preferences > Custom Preferences.

1. Activer les abonnements via Outils du commerçant > Préférences du site > Préférences personnalisées.
2. Accédez à Administration > Opérations > Services et ouvrez l'onglet Identifiants pour configurer les informations d'identification du service. Ouvrez worldline.gopay.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.
3. Cliquez sur Appliquer.
4. Configurez les services en naviguant vers l'onglet Services.
   
   • Sélectionnez les identifiants worldline.gopay.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 de vos transactions depuis notre plateforme. De cette façon, la base de données de votre boutique est toujours à jour.

• Configurez une WebhooksKeyID, 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 > Worldline_GoPay et 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-GoPay. Cliquez sur le bouton “Tester la connexion API”. Vérifiez que la boîte de dialogue affichée indique “Connexion à l'API Worldline Gopay 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-GoPay. 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.

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-GoPay 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 GoPay Worldline. Vous trouverez l'option en bas de la page.