Installez Affirm sur SFCC

Installation d'Affirm

L'installation d'Affirm sur Salesforce Commerce Cloud (SFCC) nécessite les éléments suivants :

• Importation de la cartouche Affirm.
• Importation des fichiers XML requis.
• Activation d'Affirm en tant que processeur de paiement.

Étape 1 : Importez la cartouche Affirm

1. Téléchargez la cartouche.
2. Dans le menu Salesforce UX Studio, cliquez sur >Importer des fichiers.
3. Cliquez pour développer Général, puis cliquez sur Projets existants dans Workspace.
4. Cliquez sur Suivant.

5. Cliquez sur Parcourir et accédez au répertoire dans lequel vous avez téléchargé la cartouche Affirm.

6. Une fois que la fenêtre a chargé le projet, cliquez sur Sélectionner tout.
7. Cliquez sur Terminer.
8. Cliquez avec le bouton droit sur le projet et sélectionnez Propriétés.
9. Cliquez sur Références du projet et cochez toutes les références Affirm.
10. Cliquez sur OK.
11. Une fois que Salesforce UX Studio a créé l'espace de travail, connectez-vous à Business Manager et accédez à Site > Gestion des Sites.
12. Sélectionnez votre site et cliquez sur Paramètres.
13. À la fin du champ relatif au chemin de la cartouche, ajoutez les options suivantes en fonction du type Commerce Cloud :

• Pipelines: int_affirm_controllers:int_affirm
• JavaScript controllers: int_affirm_controllers:int_affirm
• SFRA: int_affirm_sfra:int_affirm

Étape 2 : Importer les fichiers XML

Importez ensuite les fichiers XML du répertoire Metadata de la cartouche téléchargée

1. Dans le Business Manager, accédez à Administration > Développement du site > Importation et exportation du site.
2. Dans la section Importer , cliquez sur Choisir un fichier et sélectionnez affirm.zip du dossier de métadonnées.

3. Cliquez sur Télécharger.
4. Une fois le chargement terminé, sélectionnez affirm.zip dans la liste des archives, puis cliquez sur Importer.

📘

Note

Vous devez configurer l'ID de votre bibliothèque dans le fichier library.xml dans le dossier de métadonnées. Il existe actuellement une 'RefArchSharedLibrary' par défaut.

• Pour les pipelines et les contrôleurs, indiquez « SiteGenesisSharedLibrary ».
• Pour SFRA, mettez 'RefArchSharedLibrary'

5. Vérifiez que le groupe de préférences du site a été créé avec l'ID - AFFIRM_PAYMENT et le nom - Affirm.
6. Vérifiez que le mode de paiement a été créé avec ID - Affirm et le nom - Affirm. Activez le mode de paiement Affirm.
7. Vous pouvez ajouter une image ou un texte pour votre mode de paiement en mettant à jour la ressource de contenu affirm-payment-method.

📘

Note

La SFCC a demandé aux partenaires AppExchange de supprimer tous les fichiers Javascript chargés dynamiquement des réseaux de diffusion de contenu (CDNs). Ainsi, Affirm.js, qui est une bibliothèque Javascript côté navigateur servie via CDN est remplacée par une copie statique. Pour prévenir Affirm.js de devenir obsolète et s'assurer que Affirm.js reçoit des mises à jour critiques, nous recommandons à nos commerçants d'utiliser la voie CDN pour intégrer le script dans les pages de vitrine en suivant les instructions figurant sur cette page.

Étape 3 : Activez le processeur de paiement Affirm

1. Dans le Business Manager, accédez à Outils du commerçant > Commande > Processeurs de paiement.
2. Cliquez sur NOUVEAU.
3. Vérifiez que le groupe de préférences du site a été créé avec l'ID - AFFIRM_PAYMENT et le nom -- Affirm.
4. Vérifiez que le Groupe de préférences du site existe avec : 

• ID : AFFIRM_PAYMENT
• Nom : Affirm

5. Outils marchand > Commande > Modes de paiement pour vérifier que le mode de paiement existe avec :

• ID : Affirm
• Nom : Affirm

6. Cliquez sur Activer. 
7. Vous pouvez éventuellement ajouter une image ou un texte pour le mode de paiement en mettant à jour l’élément affirm-payment-method.

Code personnalisé

Vous devrez mettre à jour les fichiers modèles de votre site pour ajouter la messagerie promotionnelle et optimiser les fonctionnalités de paiement. Nous avons inclus des instructions détaillées pour ces enchantements personnalisés ci-dessous :

En outre, cliquez sur Cartes de crédit/débit pour vérifier que Visa est activé.

Configurer le traitement de la carte virtuelle

1. Connectez-vous à Business Manager et accédez à Outils Commerçant > Préférences du site > Préférences personnalisées du site > Affirm.
2. Définissez Intégration de la carte virtuelle Affirm sur Activé.
3. Ajoutez l'instrument de paiement VCN avec la dernière partie du nom du hook (par ex., BASIC_CREDIT).

Intégration avec d'autres processeurs de paiement

Notre intégration de carte virtuelle part du principe que vous traitez une carte de débit à l’aide de vos processeurs de paiement. Par défaut, il utilise le processeur BASIC_CREDIT mais si vous devez intégrer Affirm à d'autres processeurs de paiement, suivez les étapes suivantes :

1. Définir l'attribut de préférence du site Instrument de paiement VCN avec la dernière partie du nom du crochet (par ex., CYBERSOURCE_CREDIT_CARD).
2. Enregistrer le nouveau gestionnaire de hooks pour le point d’extension dw.int_affirm.payment_instrument.%PI%, où %PI% est la valeur de l'instrument de paiement que vous avez définie à l'étape précédente. (par ex., dw.int_affirm.payment_instrument.CYBERSOURCE_CREDIT_CARD). Par défaut, il est dw.int_affirm.payment_instrument.BASIC_CREDIT défini à l'intérieur /cartridge/scripts/hooks.json.
3. Implémentez une méthode " add " de ce gestionnaire de hook, qui prendra panier comme paramètre. La méthode doit retourner un mode de paiement nouvellement créé. Les informations de la carte de crédit peuvent être extraites de HttpParametersMap et une mise en page de référence se trouve dans les cartridge/scripts/payment/instrument/BASIC_CREDIT.js). Enfin, vérifiez Credit/Debit Cards pour vérifier que la carte Visa est activée.