Installer et configurer Affirm sur SAP Commerce

Disponibilité des pays

Liste des pays ⬇️

USA

Aperçu

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 :

• The transaction flow when buying with Affirm.
• Votre processus d'encaissement actuel pour comprendre comment Affirm affectera les opérations et l'expérience client.
• Settlement reports to know how to reconcile transactions with the deposits into your bank account.
• The timeline for receiving Affirm deposits into your bank account.

🚧

Développement de Sandbox

You should have received an email inviting you to create an Affirm account. Click here for information about accessing your account.

Develop and test the Affirm integration in your development environment connected to our sandbox. To use our sandbox, retrieve your sandbox API keys at https://sandbox.affirm.com/dashboard/#/apikeys for use during integration.

After development and testing, you'll need to update your integration to use your live API keys, which you can find at https://affirm.com/dashboard/#/apikeys.

Étapes d'intégration

Installing Affirm on SAP Commerce requires downloading the add-on, updating localextensions.xml, running the installation command and rebuilding/updating the system.

Télécharger le module

1. Téléchargez la source depuis le dépôt :
   • The source will need to be downloaded locally from the repo (click here) and then placed into a directory as outlined in the next step.
2. Place folders in custom folder into custom folder of SAP Commerce Suite (<HYBRIS_HOME>/bin/custom)

Mise à jour du fichier localextensions.xml

1. Check the presence of <extension name="addonsupport" /> in the localextensions.xml file
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. Go to <HYBRIS_HOME>/bin/platform and run the following command if it was not applied in this terminal:
   • Windows: setantenv.bat\
   • Unix: . ./setantenv.sh
3. Go to <HYBRIS_HOME>/bin/platform and run the installation add-on with the command:

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

Reconstruire le système

1. Go to <HYBRIS_HOME>/bin/platform and rebuild the system with the command: ant clean all.

ant clean all

2. Add /checkout/affirm/authorise to your csrf.allowed.url.patterns property.

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

After installing affirmpaymentaddon successfully, you can now login to SAP Commerce backoffice to set up the Affirm configuration and assign it to specific sites in 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.

Adding Affirm promotional messaging is a required integration step, and you should complete it before testing your integration. Click here for information about adding Affirm promotional messaging.

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. To enable Affirm promotional messaging, set Affirm Promotion Flag to True and click Save. Click on a value under List of Affirm Promotion Message for additional configuration.

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

To edit threshold, select the PaymentThreshold object from the list. Select True to set the minimum threshold and False to set the maximum threshold. Set the threshold in the Thresdhold amount field.

É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 :

Before deploying the Affirm integration to your production site, Affirm will need to test it in your development or staging environment connected to our live environment. Contact your Integration Consultant or [email protected] to coordinate this test.

Étape 5

Déploiement en production :

Connectez-vous à l'environnement Affirm en direct

1. Retrieve your live API keys at 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. Set the Sandbox Mode to False (1) and update the Affirm Private Key (2) and Public Key with the live API keys from your dashboard. Click SAVE.

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!