À propos de l'API Direct

Aperçu

L’API Direct d’Affirm est une intégration puissante et flexible qui permet aux commerçants d’intégrer directement sur leur site Web le processus complet de paiement et d’autorisation de paiement d’Affirm. Cela vous donne un contrôle total sur l'expérience utilisateur du front-end et la logique de traitement des transactions du back-end. De l’initiation de la caisse à la gestion des confirmations et des erreurs, l’API Directe offre une solution personnalisable et sécurisée adaptée aux besoins de votre entreprise.

L'expérience client

Les clients qui choisissent Affirm lors de la caisse profitent d'un parcours de marque fluide qui se déroule sur votre site (via une fenêtre modale) ou sur affirm.com (via une redirection). Lorsqu'ils choisissent Affirm :

On leur présente des options de paiement préadmissibles et des modalités du prêt.
Ils confirment leur sélection et reviennent à la page de confirmation de votre site.
Si nécessaire, des messages d'erreur modaux apparaissent pour aider les clients à entrer les données correctes.

Vous pouvez configurer les URL de redirection et d'annulation du client, et même choisir d'envoyer le checkout_token via les méthodes GET ou POST selon vos préférences de flux.

Flux d’expérience utilisateur client

Ce flux illustre l’expérience du client utilisant Affirm via une intégration API directe. Après avoir sélectionné Affirm à la caisse, le client vérifie son identité avec un numéro de téléphone cellulaire et un NIP, crée un compte et choisit des modalités de paiement. Une fois les conditions confirmées, la commande est finalisée et une page de confirmation s'affiche.

L’Expérience du Commerçant

Transaction Flow

Ce diagramme présente les principales étapes du flux de transaction de l'API Direct d'Affirm. Une fois qu’un client sélectionne Affirm et initie la caisse, le commerçant crée et envoie un objet de caisse contenant les détails de la commande et du client. Affirm recueille ensuite les renseignements du client et, après approbation, retourne un checkout_token. Le commerçant utilise ce jeton pour autoriser la transaction et finaliser la commande, garantissant ainsi un processus de paiement sécurisé de bout en bout.

Étapes clés

1. Embed Affirm.js

Ajoutez le SDK JavaScript d'Affirm à votre site <head>. Ce script crée l'objet global « affirm » et active des fonctionnalités clés telles que la caisse et les messages promotionnels. Vous trouverez le script dans la section Recettes de notre documentation pour développeurs.

2. Ajouter la messagerie promotionnelle

Utilisez les composants affirm.ui pour afficher le message « aussi peu que » sur les pages de produits, dans le panier ou sur les bannières. Cela aide les clients à comprendre les options de paiement et à encourager la conversion.

3. Initier la caisse

Appelez affirm.checkout() et définissez un objet caisse avec les détails du client, du panier et du commerçant. Ensuite, déclenchez affirm.checkout.open() pour lancer l'expérience de caisse.

4. Autoriser la transaction.

Après la caisse, recevez le checkout_token à votre URL de confirmation et envoyez-le à l’API d’Affirm pour autoriser la transaction. Conservez les transaction_id pour toute action après achat.