Magento 1

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

Notes de mise à jour de Magento
Flux de transaction Affirm
Votre processus de paiement actuel pour comprendre comment Affirm affectera les opérations et l'expérience client
Rapports de règlement pour connaître la manière de rapprocher les transactions avec les dépôts 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 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 version du paquet téléchargé.
4. Cliquez sur Téléverser.

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 vers 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. Attribuez la valeur Oui à l'option Utiliser la catégorie de catalogue plat.
3. Cliquez sur Enregistrer la configuration.
4. Accédez à Système > Configuration > Gestion des index.
5. Cliquez sur Réindexer les données pour la catégorie de données plates.

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. Accédez à Système > Configuration > Ventes > Modes de paiement > Affirm
3. Définissez Activé à Oui
4. Conserver le mode défini sur environnement de test (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 à partir du tableau de bord du commerçant Affirm sandbox.
6. Si votre processus de caisse capture automatiquement les frais, définissez Action de paiement sur Autoriser et capturer
7. Saisissez les montants en dollars pour Total minimum de commande et Total maximum de commande qui affichent Affirm comme option de paiement à vos clients lors du paiement (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 par défaut d'Affirm (Affirm doit approuver), vous pouvez ajouter du code HTML en ligne au code HTML du mode de paiement Affirm (nécessite que Apparence de texte brut soit réglé sur No).
12. Réglez Bouton de caisse activé sur Oui pour afficher le bouton Affirm sur la page du panier (vous pouvez mettre à jour l’URL du bouton Affirm dans le code du bouton de caisse)
13. Définissez 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 Créer des commandes après la confirmation 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 Effacer le cache de Magento.
3. Sign out.
4. Sign back in to reset permissions.

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 Magento, accédez à Système > Configuration > Promotions Affirm.
2. Dans les Paramètres généraux, saisissez la Clé promo Affirm.
3. Set Enabled to Yes.
4. Pour chaque page où vous souhaitez qu'une bannière soit affichée, définissez Affichage sur Oui et Taille de la promotion et Position de la promotion sur les valeurs de votre choix.

Ajouter la messagerie promotionnelle

1. Dans le panneau d'administration Magento, accédez à Système > Configuration > Promotions Affirm.
2. Dans les paramètres Fonctionnalité aussi peu que, définissez les paramètres suivants 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 d'achat (page panier)
3. Saisissez une valeur de montant minimum MPP pour définir le seuil minimum en dollars qui affichera les messages de paiement mensuels (p. ex., définir le montant minimum MPP à 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 Analytique améliorée, définissez le pixel Activer Affirm sur Oui.
3. Définissez Oui aux options de page listées sous Activer le pixel Affirm pour les pages suivantes afin d’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 à l'adresse https://affirm.com/dashboard/#/apikeys
2. Dans le panneau d’administration Magento, allez dans Système > Configuration > Ventes > Modes de paiement > Affirm
3. Définissez le Mode sur Production
4. Saisissez la clé API publique et la clé secrète (clé privée) que vous venez de récupérer dans 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.