Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Autres produits Stripe

Accepter un paiement Affirm

Comment accepter les paiements Affirm, un moyen de paiement qui permet aux clients d'acheter tout de suite et de payer plus tard.

Copier la page

Remarque

This guide helps you integrate Affirm in your online checkout. For in-person payments with Stripe Terminal, visit Additional payment methods.

Mise en garde

Stripe propose automatiquement à vos clients des options de moyens de paiement selon leur devise, les restrictions sur les moyens de paiement et d’autres paramètres. Nous vous recommandons de configurer vos moyens de paiement à partir du Dashboard Stripe en suivant les instructions indiquées dans Accepter un paiement.

Si vous souhaitez continuer à configurer manuellement les moyens de paiement proposés à vos clients avec Checkout, utilisez ce guide. Sinon, mettez à jour votre intégration pour configurer les moyens de paiement dans le Dashboard.

Affirm est un moyen de paiement à usage unique et à notification immédiate avec lequel le client doit authentifier son paiement. Les clients sont redirigés vers le site d’Affirm, ils acceptent alors les conditions d’un plan de paiement échelonné. Une fois que le client a accepté les conditions, les fonds sont garantis et transférés vers votre compte Stripe. Le client rembourse directement Affirm au fil du temps.

Remarque

Avant de commencer l’intégration, assurez-vous que votre compte est admissible à Affirm en vous rendant dans vos paramètres des moyens de paiement.

Déterminer la compatibilité

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements Affirm :

  • Vous ne pouvez utiliser que les postes ponctuels. Affirm ne prend pas en charge les plans d’abonnement récurrents.
  • Les tarifs doivent être exprimés dans la devise locale.

Accepter un paiement

Remarque

Ce guide s’appuie sur l’intégration de base de Checkout permettant d’accepter un paiement.

Suivez ce guide pour savoir comment activer Affirm et découvrir les différences entre l’acceptation d’un paiement par carte bancaire et l’utilisation d’Affirm.

Activer le moyen de paiement Affirm

Lors de la création d’une nouvelle session Checkout, vous devez :

  1. Ajoutez affirm à la liste payment_method_types.
  2. Veiller à ce que tous vos line_items utilisent votre devise locale.
  3. Nous vous recommandons de collecter les adresses de livraison en ajoutant votre pays au paramètre shipping_address_collection[allowed_countries]. Si vous ne souhaitez pas collecter l’adresse de livraison avec Checkout, vous pouvez également la fournir à l’aide de payment_intent_data[shipping]. Ces informations sont utiles pour le calcul des taux d’approbation de prêt.
Stripe::Checkout::Session.create({
      mode: 'payment',
      payment_method_types: ['card'],
      payment_method_types: ['card', 'affirm'],
      line_items: [{
        price_data: {
          currency: 'usd',
          product_data: {
            name: 'T-shirt',
          },
          # Make sure the total amount fits within Affirm's transaction amount limits
          unit_amount: 5000,
        },
        quantity: 1,
      }],
      shipping_address_collection: {
        # Shipping address is optional but recommended to pass in
        # Specify which shipping countries Checkout should provide as options for shipping locations
        allowed_countries: ['CA', 'US'],
      },
      # If you already have the shipping address, provide it in payment_intent_data:
      # payment_intent_data: {
      #   shipping: {
      #     name: 'Jenny Rosen',
      #     address: {
      #       line1: '1234 Main Street',
      #       city: 'San Francisco',
      #       state: 'CA',
      #       country: 'US',
      #       postal_code: '94111',
      #     },
      #   },
      # },
      success_url: 'https://example.com/success',
      cancel_url: 'https://example.com/cancel',
    })

Traiter vos commandes

Utilisez une méthode telle que les webhooks pour gérer le traitement de la commande plutôt que d’attendre que votre client revienne sur la page de l’état du paiement.

Les événements suivants sont envoyés lorsque l’état du paiement change :

Nom de l’événementDescriptionÉtapes suivantes
checkout.session.completedLe client a autorisé le paiement en envoyant le formulaire Checkout.Attendez que le paiement aboutisse ou échoue.
payment_intent.succeededLe paiement du client a abouti. Le PaymentIntent bascule à l’état succeeded.Traitez la commande de biens ou de services du client.
payment_intent.payment_failedLe paiement du client a été refusé, ou le paiement a échoué pour un autre motif. Le PaymentIntent revient à l’état requires_payment_method.Contactez votre client par e-mail et demandez-lui de passer une nouvelle commande.

En savoir plus sur la réalisation des commandes.

Tester votre intégration

Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement Affirm, puis cliquez sur le bouton Payer.

Testez votre intégration Affirm en affichant la page de redirection à l’aide de vos clés API de test. Vous pouvez tester la réussite de paiement en l’authentifiant sur la page de redirection. Le PaymentIntent passe alors de l’état requires_action à succeeded.

Pour tester un échec d’authentification de l’utilisateur, utilisez vos clés API de test et accédez à la page de redirection. Sur cette page, fermez la fenêtre modale Affirm et vérifiez que le paiement a échoué. L’état du PaymentIntent passe de requires_action à requires_payment_method.

Lorsque le système vous redirige vers l’environnement de test d’Affirm, Affirm peut vous demander les quatre derniers chiffres de votre SSN. Affirm suggère d’utiliser '0000' ou '5678'.

Pour les PaymentIntents à capture manuelle en mode test, le PaymentIntent non capturé expire automatiquement 10 minutes après l’aboutissement de l’autorisation.

Échecs de paiement

Affirm prend en compte de nombreux facteurs pour accepter ou refuser une transaction (par exemple, la durée d’utilisation d’Affirm par le client, le montant restant que le client doit rembourser et la valeur de la commande actuelle).

Présentez toujours des options de paiement supplémentaires telles que card dans votre tunnel de paiement, car les paiements Affirm ont un taux de refus supérieur aux autres moyens de paiement. Dans ces cas, le PaymentMethod est détaché et l’état de l’objet PaymentIntent passe automatiquement à requires_payment_method.

Hormis le refus d’un paiement, pour un PaymentIntent d’Affirm avec un état requires_action, les clients doivent effectuer le paiement sous 12 heures une fois que vous les avez redirigés vers le site d’Affirm. Si aucune action n’est prise par le client sous 12 heures, le PaymentMethod est détaché et l’état de l’objet PaymentIntent passe automatiquement à requires_payment_method.

Dans ce cas, informez votre client pour réessayer avec une option de paiement différente présentée dans votre tunnel de paiement.

Codes d’erreur

Voici les codes d’erreur courants et les actions recommandées correspondantes :

Code d’erreurAction recommandée
payment_intent_payment_attempt_failedErreur générique indiquant l’échec du paiement Affirm. Des informations supplémentaires peuvent être fournies dans le motif de l’erreur de paiement.
payment_method_provider_declineAffirm a refusé le paiement du client. Le client doit désormais contacter Affirm pour obtenir plus d’informations.
payment_intent_payment_attempt_expiredLe client n’a jamais effectué le paiement sur la page de paiement d’Affirm et la session a expiré. Stripe fait automatiquement expirer les PaymentIntents qui n’ont pas été autorisés 12 heures après la création de la session de paiement.
payment_method_not_availableAffirm a rencontré une erreur liée au service et n’est pas en mesure de répondre à la demande. Réessayez ultérieurement.
amount_too_smallSaisissez un montant compris dans les limites de transaction par défaut d’Affirm.
amount_too_largeSaisissez un montant compris dans les limites de transaction par défaut d’Affirm.

Pour certaines erreurs, des informations supplémentaires peuvent être fournies dans le motif de l’erreur de paiement :

Motif de l’erreurSignification
generic_declineMotif par défaut d’une erreur de paiement. Cela indique généralement que le partenaire a refusé le paiement (par exemple, en raison de fonds insuffisants), que l’émetteur a refusé le paiement, que la transaction comportait un achat à haut risque ou un motif similaire. Dans ces cas de figure, Stripe ne reçoit pas toujours de motif de refus.
affirm_checkout_canceledSoit le client a annulé le paiement Affirm, soit Affirm a rejeté l’éligibilité du client au prêt. Stripe ne peut pas faire la différence entre ces deux types d’événements.
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc