Liste de vérification d'intégration

Utilisez cette liste de vérification pour suivre votre progression. Chaque élément correspond aux détails figurant dans Configurer le paiement express

Conditions préalables

• Créez un compte dans le Tableau de bord des commerçants Affirm
• Intégrez l’option Paiement Affirm par défaut
• Accédez à vos clés API publiques et privées
• Contactez votre gestionnaire de compte Affirm pour confirmer la disponibilité et connaître les prochaines étapes pour construire vos API

Étape 1 : Créer un identifiant de commande unique

• Générez un identifiant unique à forte entropie (p. ex. UUID) dans votre système principal

Étape 2 : Configurer Paiement express Affirm

• Définissez checkout_variant: "express" dans la propriété du commerçant
• Définissez shipping_and_totals_callback_url sur votre point de terminaison de serveur à serveur
• Définissez order_id sur l'identifiant unique généré à l'étape 1
• Fournissez lesubtotal dans les métadonnées (coût de l'article avant taxes/frais d'expédition)
• Omettez les champs shipping object et total
• Incluez d’autres attributs standard de l’objet de paiement

Étape 3 : Configurer le point de terminaison HTTP « Livraison et totaux »

• Le point de terminaison accepte order_id, currency et l'adresse de livraison
• Le point de terminaison retourne un tableau order_id, currency, subtotal et shipping_options avec shipping_type, shipping_label, shipping_amount, tax_amount et total par option
• Vérifiez l'en-tête HMAC X-Affirm-Signature sur toutes les requêtes entrantes
• Servez le point de terminaison via HTTPS (TLS 1.2+)
• Respectez l’objectif de temps de réponse de 5 secondes défini dans le SLA
• Gérez les erreurs en renvoyant HTTP 422 avec un tableau d'erreurs
• Enregistrez le ou les modèles de noms d’hôte de vos URL de rappel auprès de votre TAM
• Ajoutez les adresses IP sortantes d’Affirm à la liste d’autorisation de votre CDN ou de votre pare-feu (contactez votre TAM pour obtenir la liste)

Étape 4 : Calculer le total de la commande

• Lors de la confirmation du paiement, appelez l’API de lecture de caisse (GET /api/v2/checkout/{checkout_id})
• Calculer le total final de la commande à partir des détails d’expédition retournés
• Appelez l’API d’autorisation de transaction (POST /api/v1/transactions) avec le jeton de paiement et l’ID de commande
• Vérifiez que le montant total calculé correspond au montant du prêt autorisé
• Finalisez la commande, puis redirigez le client vers la page de succès ou d'échec en fonction de la validation

Étape 5 : Ajouter le bouton de paiement Affirm

• Ajoutez à votre site Web le bouton de paiement Affirm préconfiguré pour bénéficier du Paiement express