AccueilCommencerSolutionsPlateformesIntégrations globales
DocsRéférence APIRecetteChangelog
AccueilCommencerSolutionsPlateformesIntégrations globalesSe connecter
Docs
Commencez à taper pour rechercher...

Magento 1

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

📘

Magento 1 coucher de soleil

  • Effective June 30 2020, Adobe sunsetted support for Magento 1. This means Adobe will no longer release security patches for Magento 1. If you have any questions, see Adobe’s End of Software Support FAQ.

  • We'll continue to support merchants using our integration on Magento 1. You can navigate to our integration guides here.

  • 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

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.

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

You have several options for installing the Magento extension. 

Click here if you already have the Magento extension installed and need information on updating it.

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. Download the latest package release (the compressed .tgz file).
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. Download the Makefile, which requires git and wget
2. Copy the Makefile to MAGENTO_ROOT
3. To install, run the command make install
4. To update, run the command 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

Affirm promotional messaging components---monthly payment messaging and educational modals---show customers how they can use Affirm to finance their purchases. Properly placed promotional messaging helps drive increased AOV and conversion. Add Affirm promotional messaging to your product, category, and cart pages.

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

Multiple Financing Programs (MFPs) allow you to offer custom financing programs to your customers based on rules you define in Magento . To use MFPs in Magento, you must be running version 3.3.0 or higher of the extension. To learn more about MFPs and how to set them up in Magento, contact your Client Success Manager.

4. Ajoutez la fonction Page de confirmation

Confirmation Page Analytics is available in version 3.5.6 and up of the Magento extension. To enable confirmation page analytics:

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

Processing orders (authorize, void, invoice, or credit memo) in Magento updates the order status in the Affirm dashboard. While you can process orders in the dashboard, we strongly recommend using Magento to keep order status synced with Affirm. Click here for more information.

6. Testez votre intégration

After completing your integration, do a thorough testing of both your front-end and order management functions in our sandbox to ensure that everything works as expected. Click here for our recommended test plan. However, you'll need to tailor your testing plan to your specific systems, processes, and integration.

7. Déploiement en production

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.

Connectez-vous à l'environnement Affirm en direct

1. Retrieve your live API keys at 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?

If you have multiple sites operating under a single Affirm account, you can override the external company or brand name that the customer sees by adding a name field to the checkout object in the Magento extension payment.php file. This affects all references to your company name in the Affirm UI.

'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?

You can use a different reference name to place monthly payment messaging on the product detail page based on the page's layout. You'll need to modify reference name in your affirm.xml layout file by replacing the product.info.extrahint reference name with any other reference name based on your layout structure. If you're looking for a way to position blocks before or after other blocks in the layout, you can modify the before and after block attributes. Some reference name examples to use instead of product.info.extrahint from the standard product page layout structure include alert.urls, product.info.social, and 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 18 days ago

Autres ressources utiles

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