Installer et configurer Affirm sur SAP Commerce

Introduction

Ce guide décrit la manière d'intégrer Affirm à votre plateforme SAP Commerce, afin de pouvoir fournir Affirm comme option de paiement à vos clients. Après avoir intégré Affirm, votre site SAP Commerce :

• Proposera Affirm comme option de paiement à la page de la caisse.
• Traitera les charges Affirm dans votre système de gestion des commandes.
• Affichera la messagerie promotionnelle d'Affirm.

Conditions préalables

Avant de commencer l'intégration, vous devez prendre connaissance des points suivants :

• Le déroulement de la transaction lors d'un achat avec Affirm.
• Votre processus d'encaissement actuel pour comprendre comment Affirm affectera les opérations et l'expérience client.
• Les rapports de règlement indiquent comment rapprocher les transactions avec les dépôts sur votre compte bancaire.
• Le délai de réception des dépôts Affirm sur votre compte bancaire.

🚧

Développement de Sandbox

Vous devriez avoir reçu un courriel vous invitant à créer un compte Affirm. Cliquez ici pour en savoir plus sur l'accès à votre compte.

Développez et testez l'intégration d'Affirm dans votre environnement de développement connecté à notre sandbox. Pour utiliser notre sandbox, récupérez vos clés API sandbox à l'adresse https://sandbox.affirm.com/dashboard/#/apikey à utiliser pendant l'intégration.

Après le développement et les tests, vous devrez mettre à jour votre intégration pour utiliser vos clés API en direct, que vous trouverez à l'adresse https://affirm.com/dashboard/#/apikey.

Étapes d'intégration

L’installation d’Affirm sur SAP Commerce nécessite le téléchargement du module complémentaire, la mise à jour de localextensions.xml, l'exécution de la commande d'installation et la reconstruction/mise à jour du système.

Télécharger le module

1. Téléchargez la source depuis le dépôt :
   • La source devra être téléchargée localement depuis le repo (cliquez ici) puis placée dans un répertoire comme indiqué dans l'étape suivante.
2. Place folders in custom folder into custom folder of SAP Commerce Suite (<HYBRIS_HOME>/bin/custom)

Mise à jour du fichier localextensions.xml

1. Vérifier la présence de <extension name="addonsupport" /> dans le fichier localextensions.xml
2. Add extension <extension name=" affirmpaymentaddon " />
3. Add extension <extension name="affirmpaymentcore" />
4. Add extension <extension name="'affirmpaymentfulfilmentprocess'" />
5. Vérifiez la présence de l'extension de storefront

Exécuter la commande d'installation

1. Si SAP Commerce est en cours d'exécution, arrêtez-le. Selon le mode de démarrage du serveur, nous pouvons utiliser l'une des méthodes suivantes pour arrêter le serveur SAP Commerce.
   • Si le serveur SAP Commerce a été démarré en mode intégré, appuyez sur Ctrl+C pour arrêter le serveur SAP Commerce.
   • Si le serveur SAP Commerce a été démarré en mode service, exécutez la commande suivante pour arrêter :
     • Windows: hybrisserver.bat stop\
     • Unix: ./hybrisserver.sh stop\
2. Accédez à <HYBRIS_HOME>/bin/platform et exécutez la commande suivante si elle n'a pas été appliquée dans ce terminal :
   • Windows: setantenv.bat\
   • Unix: . ./setantenv.sh
3. Accédez à <HYBRIS_HOME>/bin/platform et exécutez le module complémentaire d'installation avec la commande :

ant addoninstall -Daddonnames="affirmpaymentaddon" -DaddonStorefront.yacceleratorstorefront="yacceleratorstorefront"

Reconstruire le système

1. Accédez à <HYBRIS_HOME>/bin/platform et construire le système avec la commande : tout nettoyer.

ant clean all

2. Ajoutez /checkout/affirm/authorise à votre propriété csrf.allowed.url.patterns .

csrf.allowed.url.patterns=/[^/]+(/[^?]*)+(sop/response)$,/[^/]+(/[^?]*)+(merchant_callback)$,/[^/]+(/[^?]*)+(hop/response)$,/[^/]+(/[^?]*)+(language)$,/[^/]+(/[^?]*)+(currency)$,/checkout/affirm/authorise

Mettre à jour le système

Après l'étape précédente, vous devrez peut-être effectuer une initialisation complète via SAP Commerce Administration Console (AC) s'il s'agit de la première installation de SAP Commerce.

Si vous avez déjà effectué l'initialisation complète, vous devez mettre à jour votre système SAP Commerce comme suit :

1. Ouvrez le navigateur Web, accédez à HaC → Plateforme → Mettre à jour.
2. Deselect the checkbox stating Create essential data".

3. Select the checkboxes next to affirmpaymentcore,affirmpaymentfulfilmentprocess and affirmpaymentaddon

4. Cliquez sur le bouton Mettre à jour pour mettre à jour le système SAP Commerce.

2. Activer et configurer Affirm comme option de paiement

Après l'installation affirmpaymentaddon avec succès, vous pouvez maintenant vous connecter au backoffice SAP Commerce pour configurer Affirm et l'attribuer à des sites spécifiques dans SAP Commerce.

1. Connectez-vous au backoffice avec les informations d'ID d'administrateur.
2. Afficher la configuration Affirm Payments

Mise à jour des paramètres Affirm

📘

Note

Les modifications apportées aux paramètres Affirm pour BaseSite sont effectuées dans AffirmConfigContainer, qui est les configurations liées au conteneur. AffirmConfigContainer est ajouté en tant qu'attribut à BaseSite pour prendre en charge Affirm

Pour afficher ou modifier la configuration Affirm, dans SAP Commerce Backoffice, accédez à WCMS → Site Web → ADMINISTRATION → Affirm Config Container for CMSSite.

3. Modifiez les champs de Configuration des Paiements Affirm

3. Configurer la messagerie promotionnelle Affirm

Les composants des messages promotionnels Affirm - messages de paiement mensuels et modaux éducatifs---expliquent aux clients comment ils peuvent utiliser Affirm pour financer leurs achats. Des messages promotionnels correctement placés contribuent à augmenter la VMC Valeur Moyenne des Commandes et la conversion.

L'ajout de la messagerie promotionnelle d'Affirm est une étape d'intégration requise, et vous devez le terminer avant de tester votre intégration. Cliquez ici pour plus d'informations sur l'ajout de la messagerie promotionnelles d'Affirm.

1. 1. Accédez à la configuration Affirm décrite à la section 2, allez dans WCMS → Site web → ADMINISTRATION → Conteneur de configuration Affirm pour CMSSite
2. Double-cliquez sur la configuration de la page Affirm.

3. Pour activer la messagerie promotionnelle Affirm, définissez Indicateur de promotion Affirm sur True et cliquez sur Enregistrer. Cliquez sur une valeur sous Liste des messages de promotion Affirm pour une configuration supplémentaire.

4. Faites défiler jusqu'aux paramètres d'administration et cliquez sur Enregistrer pour enregistrer les modifications.

Options de configuration (facultatif)

Il est possible de restreindre Affirm comme option de paiement sur la page de la caisse en fonction des totaux minimum ou maximum du panier. Si vous souhaitez qu'Affirm s'affiche pour tous les seuils de panier, cette étape peut être ignorée.

Étape 1

Pour modifier/afficher les seuils, connectez-vous au Backoffice avec les renseignements d'identification de l'administrateur, accédez à Paramètres des prix - Modes de paiement et sélectionnez Affirm. Sélectionnez l'onglet Administration et faites défiler l'écran vers le bas jusqu'à Paramètres des seuils.

Étape 2

Pour modifier le seuil, sélectionnez l'objet PaymentThreshold de la liste. Sélectionnez True pour définir le seuil minimal et False pour définir le seuil maximum. Définissez le seuil dans le champ Montant de la prise en flèche .

Étape 3 :

Vérifier vos fonctions de gestion des commandes :

Le traitement des commandes ( annulation , remboursement et remboursement partiel) sur SAP Commerce met à jour le statut de la commande dans le tableau de bord Affirm. Bien que vous puissiez traiter les commandes dans le tableau de bord, nous vous recommandons d'utiliser le statut des commandes de SAP Commerce BackOffice pour que le statut des commandes reste synchronisé avec Affirm.

Étape 4

Coordonner les tests avec Affirm :

Avant de déployer l'intégration Affirm sur votre site de production, Affirm devra le tester dans votre environnement de développement ou de pré-production connecté à notre environnement en direct. Communiquez avec votre consultant en intégration ou [courriel protégé] pour coordonner ce test.

Étape 5

Déploiement en production :

Connectez-vous à l'environnement Affirm en direct

1. Récupérez vos clés d'API en direct sur https://affirm.com/dashboard/#/apikeys
2. Accédez à la configuration Affirm décrite à la section 2, allez dans WCMS Site web Site web ADMINISTRATION Affirm Conteneur de configuration Affirm Affirm pour CMSSite
3. Définissez le mode Sandbox sur False (1) et mettez à jour la clé privée Affirm (2) et la clé publique avec les clés API de votre tableau de bord. Cliquez sur ENREGISTRER.

Du lancement à la production

Une fois que vous êtes connecté à notre environnement de production et que nous avons testé votre intégration, vous êtes prêt à vous déployer dans votre environnement de production et à offrir Affirm comme option de paiement à vos clients!