AccueilCommencerSolutionsPlateformesIntégrations globales
Docs

Magento 1

Découvrez comment intégrer Affirm à votre plateforme de commerce électronique Magento

Suggérer des modifications

📘

Magento 1 coucher de soleil

  • À compter du 30 juin 2020, Adobe a supprimé la prise en charge de Magento 1. Cela signifie qu'Adobe ne publiera plus de correctifs de sécurité pour Magento 1. Si vous avez des questions, consultez la FAQ sur la fin du support logiciel d'Adobe .

  • Nous continuerons à soutenir les commerçants qui utilisent notre intégration sur Magento 1. Vous pouvez accéder à nos guides d'intégration ici.

  • Si vous décidez de migrer votre intégration Affirm vers Magento 2, veuillez communiquer avec votre consultant en intégration ou joindre notre équipe de soutien en utilisant le widget au bas de la page. Nous sommes heureux de vous aider dans la mesure du possible!

Aperçu

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

  • Proposera Affirm comme option de paiement à la page de la caisse
  • Traitera les frais Affirm dans votre système de gestion des commandes
  • Affichera les messages promotionnels d'Affirm

Avant de commencer

Avant de commencer l'intégration, vous devez examiner :

Développement de Sandbox

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

Développez et testez l'intégration d'Affirm dans votre environnement de développement connecté à notre bac à sable. Pour utiliser notre bac à sable, récupérez vos clés API sandbox sur https://sandbox.affirm.com/dashboard/#/apikeys à 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 d'API actives, que vous trouverez à l'adresse https://affirm.com/dashboard/#/apikeys.

1. Installez l'extension Magento

🚧

Remarque importante

  • Installez l'extension dans votre environnement de bac à sable ou de simulation avant de la mettre en ligne
    • Conservez une copie de votre magasin Magento et de votre base de données afin de pouvoir revenir à la version antérieure à l'installation de l'application
    • Vous devrez peut-être réindexer tous les produits et tables de catégories après la mise à niveau de l'extension

Vous avez plusieurs options pour installer l'extension Magento. 

Cliquez ici si l'extension Magento est déjà installée et que vous avez besoin de renseignements sur sa mise à jour.

Installer à l'aide de modgit

1. Exécutez la commande suivante :

cd MAGENTO_ROOT modgit init modgit -i extension/:. add Magento_Affirm 
https://github.com/Affirm/Magento_Affirm.git

2. Mettez à jour l'extension en exécutant les opérations suivantes :

modgit update Magento_Affirm

Installer avec modman

1. Exécutez la commande suivante :

cd MAGENTO_ROOT modman clone https://github.com/Affirm/Magento_Affirm.git

2. Mettez à jour l'extension en exécutant :

modman update Magento_Affirm

Installer à l'aide du Magento Connect Manager

1. Téléchargez la dernière version  du paquet (le fichier .tgz compressé) ).
2. Dans votre panneau d'administration Magento, accédez à Système > Magento Connect > Magento Connect Manager.
3. Cliquez sur Choisir un fichier et sélectionnez le fichier de livraison du paquet téléchargé.
4. Cliquez sur Télécharger.

Installer en utilisant le script de déploiement d'Affirm

1. Téléchargez le Makefile, qui nécessite git et wget.
2. Copiez le Makefile sur MAGENTO_ROOT.
3. Pour installer, exécutez la commande make install.
4. Pour mettre à jour, exécutez la commande make update.

🚧

Problèmes d'installation connus

Vous pouvez rencontrer des erreurs SQL "Column not found" pendant l'installation. Assurez-vous de disposer des autorisations appropriées pour mettre à jour les tables de base de données Magento. Comme le processus d'installation met à jour de nombreuses tables de base de données, vous devez réindexer la table de catégories plates pour résoudre les erreurs SQL qui surviennent lors de l'installation en procédant comme suit :

1. Accédez à Système > Configuration > Fenêtre Catalogue > Frontend.
2. Définissez l'option Utiliser la catégorie du catalogue plat sur Oui.
3. Cliquez sur Enregistrer la configuration.
4. Accédez à Système > Configuration > Gestion des index.
5. Cliquez sur Réindex les données pour Données plates de catégorie.

Vous devrez peut-être exécuter la commande de réindexation via shell :

php indexer.php --reindexall

2. Configurer Affirm comme mode de paiement

Après avoir installé l'extension, activez Affirm comme mode de paiement en mettant à jour les configurations de Magento :

1. Connectez-vous à votre portail d'administration Magento
2. Allez sur System > Configuration > Ventes > Méthodes de paiement > Affirm
3. Définissez Activé sur Oui
4. Maintenez le mode sur Sandbox (pour le développement et les tests)
5. Saisissez la clé API publique et la clé secrète (clé privée) que vous avez récupérées sur le tableau de bord commerçant de la sandbox Affirm
6. Si votre processus de paiement capture automatiquement les frais, définissez Action de paiement sur Autoriser et capturer
7. Saisissez les valeurs de montant en dollars pour Total minimum de commande et Total de commande maximum qui affiche Affirm comme option de paiement pour vos clients (facultatif)
8. Si vous souhaitez modifier l'ordre d'affichage d'Affirm comme option de paiement lors du paiement, saisissez une valeur de Ordre de tri supérieure à 0
9. Si vous souhaitez désactiver Affirm lorsqu'un article en attente est dans le panier, définissez Désactiver pour les articles en rupture de stock sur Oui
10. Si vous souhaitez afficher Affirm sous forme de texte au lieu d’un logo lors du paiement, définissez Apparence du texte brut sur Oui
11. Si vous souhaitez personnaliser le logo et le sous-texte Affirm par défaut (Affirm doit approuver), vous pouvez ajouter du code HTML en ligne au code HTML du mode de paiement Affirm (nécessite l’option Apparence du texte du plan définie sur Non)
12. Réglez le bouton de paiement activé sur Oui pour afficher le bouton Affirmer sur la page du panier (vous pouvez mettre à jour l’URL du bouton Affirmer dans le code du bouton de paiement)
13. Définissez le type de flux de retrait sur Flux de retrait à l’aide de Modal pour utiliser un mode de paiement.
14. Conserver la caisse utilise xhr défini sur Détection automatique
15. Conserver la confirmation Créer des commandes après Affirm définie sur Oui (Non crée des commandes dès que l'utilisateur commence le paiement Affirm)

Si ces modifications n'entrent pas en vigueur immédiatement :

1. Dans le panneau d'administration Magento, accédez à Système > Gestion du cache.
2. Cliquez sur Flush Magento Cache.
3. Déconnectez-vous.
4. Reconnectez-vous pour réinitialiser les autorisations.

Ajouter la messagerie promotionnelle d'Affirm

Messagerie promotionnelle Affirm Les composants - messages de paiement mensuels et modaux éducatifs - montrent aux clients comment ils peuvent utiliser Affirm pour financer leurs achats. Des messages promotionnels correctement placés contribuent à augmenter la VMC et la conversion. Ajoutez des messages promotionnels Affirm à vos pages de produits, de catégories et de paniers.

Ajouter des bannières promotionnelles

Pour ajouter des images de bannière Affirm à différentes pages de votre site :

1. Dans le panneau d'administration de Magento, accédez à System > Configuration > Promos Affirm.
2. Dans Paramètres généraux, saisissez la clé Affirm Promo.
3. Définissez Activé sur Oui.
4. Pour chaque page où vous souhaitez afficher une bannière, définissez Affichage sur Oui et Taille de promo, et Position de la promo sur les valeurs de votre choix.

Ajouter la messagerie promotionnelle

1. Dans le panneau d’administration de Magento, accédez à Configuration du > système > Promos Affirm.
2. Dans les paramètres Fonctionnalité aussi peu que, définissez ce qui suit sur Oui pour afficher des messages promotionnels sur ces pages :

  • Activer pour les PDP (pages de produits)
  • Activer pour les PLP de catégorie (pages de catégorie)
  • Activer pour le panier (page du panier)
    3. Saisissez une valeur de montant minimum MPP pour définir le montant minimum en dollars qui affichera les messages de paiement mensuels (par exemple, définir le montant minimum MPP sur 100 n'affichera que les messages de paiement mensuels pour les achats supérieurs à 100 $).
    4. Vous pouvez éventuellement saisir une valeur Promo ID dans Données de l'ID de promo (communiquez avec l'équipe de réussite du client Affirm pour obtenir plus de renseignements sur les numéros de promotion).

Utilisation de plusieurs programmes de financement

Plusieurs programmes de financement (MFP) vous permettent d'offrir des programmes de financement personnalisés à vos clients en fonction des règles que vous définissez dans Magento . Pour utiliser les MFP dans Magento, vous devez exécuter la version 3.3.0 ou plus de l'extension. Pour en savoir plus sur les MFP et leur configuration dans Magento, communiquez avec le gestionnaire de réussite du client.

4. Ajoutez la fonction Page de confirmation

Confirmation Page Analytics est disponible dans la version 3.5.6 et supérieure de l’extension Magento. Pour activer l'analytique de la page de confirmation :

1. Accédez à Système > Configuration > Promotions Affirm
2. Dans la section Analyses améliorées, définissez le pixel Activer Affirm sur Oui
3. Définissez Oui pour les options de page répertoriées sous Activer le pixel Affirm pour les pages suivantes pour activer les pixels sur les pages respectives.

5. Vérifiez vos fonctions de gestion des commandes

Le traitement des commandes (autorisation, annulation, facture ou note de crédit) dans Magento 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 vivement d'utiliser Magento pour maintenir l'état des commandes synchronisé avec Affirm.Cliquez ici pour obtenir plus de renseignements.

6. Testez votre intégration

Après avoir terminé votre intégration, effectuez un test approfondi de vos fonctions d'avant-plan et de gestion des commandes dans notre sandbox pour vous assurer que tout fonctionne comme prévu.Cliquez ici pour consulter notre plan de test recommandé. Cependant, vous devrez adapter votre plan de test à vos systèmes, processus et intégrations spécifiques.

7. Déploiement en production

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.

Connectez-vous à l'environnement Affirm en direct

1. Récupérez vos clés API en direct sur https://affirm.com/dashboard/#/apikeys
2. Dans le panneau d'administration de Magento, allez à Système > Configuration > Ventes > Méthodes de paiement > Affirm
3. Définissez Mode sur Production
4. Saisissez la clé API publique et la clé secrète (clé privée) que vous venez de récupérer sur le tableau de bord du commerçant Affirm.

Du lancement à la production

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

FAQ

1. Comment mettre à jour mon nom commerçant ou de ma marque dans le flux de paiement Affirm si plusieurs sites fonctionnent avec le même compte Affirm?

Si plusieurs sites fonctionnent sous un seul compte Affirm, vous pouvez remplacer le nom de la société externe ou de la marque que le client voit en ajoutant un champ de nom à l'objet de paiement dans le fichier payment.php de l'extension Magento. Cela affecte toutes les références au nom de votre entreprise dans l'interface utilisateur Affirm.

'merchant' => array(
                'public_api_key' => Mage::helper('affirm')->getApiKey(),
                'user_confirmation_url' => Mage::getUrl('affirm/payment/confirm', array('_secure' => true)),
                'user_cancel_url' => Mage::helper('checkout/url')->getCheckoutUrl(),
                'user_confirmation_url_action' => 'GET',
                'charge_declined_url' => Mage::helper('checkout/url')->getCheckoutUrl(),\
                'name' => Mage::app()->getStore()->getFrontendName()
            ),

2. Comment modifier le placement mensuel des messages de paiement sur la page des détails du produit?

Vous pouvez utiliser un nom de référence différent pour placer un message de paiement mensuel sur la page des détails du produit en fonction de la mise en page de la page. Vous devrez modifier le nom de référence dans votre fichier affirm.xmlfichier de mise en page en remplaçant le fichier product.info.extrahint nom de référence avec tout autre nom de référence basé sur votre structure de mise en page. Si vous cherchez un moyen de positionner des blocs avant ou après d'autres blocs dans la mise en page, vous pouvez modifier les attributs de bloc avant et après. Quelques exemples de noms de référence à utiliser à la place de product.info.extrahint à partir de la structure de présentation de page de produit standard, incluez alert.urls, product.info.social, et product.info.addtocart.

Vous devrez peut-être ajuster les styles en fonction de votre structure de mise en page et de vos modèles de thème.

<catalog_product_view>
    <reference name="head">
        <action method="addItem">
            <type>skin_js</type>
            <name helper="affirm/promo_data/getPDPAffirmJsScript" />
        </action>
    </reference>
    <reference name="product.info.extrahint">
        <block type="affirm/promo_asLowAs_product" name="as.low.as.pdp"
               template="affirm/promo/aslowas/product.phtml" after="-" />
    </reference>
</catalog_product_view>

3. Comment savoir si mon extension Caisse en une seule page fonctionnera?

Affirm a un support intégré pour de nombreuses extensions de paiement en une page.  Si vous utilisez une extension de paiement d'une page, veuillez vous assurer que les tests appropriés en développement et en pré-production avant la production, car certaines extensions peuvent nécessiter des modifications supplémentaires pour fonctionner correctement avec Affirm.Pour obtenir de l'aide supplémentaire concernant la caisse en une page, veuillez communiquer avec nous. 

Mis à jour 11 months ago

Autres ressources utiles

Consultez ces ressources supplémentaires utiles pour gérer vos opérations quotidiennes avec Affirm.