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 ANZ Worldline Payment Solutions . 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 ANZ Worldline Payment Solutions
      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 ANZ Worldline Payment Solutions 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 ANZ Worldline Payment Solutions 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 ANZ Worldline Payment Solutions existantes et remplacez toutes les étapes de tâche Worldline Direct obsolètes par les étapes de tâche ANZ Worldline Payment Solutions 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 ANZ Worldline Payment Solutions 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 (Shared Config)

Click "Save" in the upper-right corner of the screen.

WORLDLINE_GOPAY_3DS (3-D Secure config)

WORLDLINE_GOPAY_HCP (Hosted Checkout Page Settings)

WORLDLINE_GOPAY_HTP (Hosted Tokenization Page Settings)

WORLDLINE_GOPAY_WEBHOOKS (Webhooks config)

WORLDLINE_GOPAY_MOBILE (Mobile Payments)

Configure payment methods and integration methods

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 the relevant payment method. Make sure to select YES for enabled. Perform the actions as stated in the table:

You can also fetch, view or hide, customise and sort all available payment methods on your ANZ Worldline Payment Solutions account into the Business Manager. Navigate to Merchant tools > Ordering > Worldline-GoPay Payment Products to see all payment methods available on your ANZ Worldline Payment Solutions account. Refresh the list whenever you activate new payment methods on your account to update it. From this page, you can also hide payment methods if you do not want them to be available on the checkout page.

Configurations supplémentaires

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 :

• Activer les abonnements via Outils du commerçant > Préférences du site > Préférences personnalisées.
• 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.
• Cliquez sur Appliquer.
• 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 actuel 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}/WorldlineGoPay-Webhooks
• Allez dans Outils Marchand > Préférences du site > Préférences personnalisées > Worldline_GoPay : Webhooks Config et cliquez sur “WORLDLINE_GoPay_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-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.

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