Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed Payments
Paiements par TPE
Moyens de paiement
Scénarios de paiement
Au-delà des paiements

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.

Remarque

Ce guide vous aide à intégrer Affirm dans votre tunnel de paiement en ligne. Pour les paiements en personne avec Stripe Terminal, consultez les moyens de paiement supplémentaires.

Mise en garde

Stripe peut automatiquement proposer les moyens de paiement pertinents à vos clients en évaluant la devise, les restrictions liées aux moyens de paiement et d’autres paramètres.

  • Suivez le guide Accepter un paiement pour créer une intégration de paiement qui utilise des moyens de paiement dynamiques.
  • Si vous ne souhaitez pas utiliser de moyens de paiement dynamiques, suivez les étapes ci-dessous pour configurer manuellement les moyens de paiement dans votre intégration Checkout.

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.

Ce guide vous explique comment activer Affirm et vous montre les différences entre l’acceptation de paiements à l’aide de moyens de paiement dynamiques et la configuration manuelle des moyens de paiement.

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. Assurez-vous que tous vos line_items utilisent votre devise nationale et que le montant total ne dépasse pas les limites de transactions Affirm.
  3. Si vous le souhaitez, indiquez les pays autorisés pour le Checkout des lieux de livraison par shipping_address_collection[allowed_countries].
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=5000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=affirm \
  -d "shipping_address_collection[allowed_countries][0]"=CA \
  -d "shipping_address_collection[allowed_countries][1]"=US \
  --data-urlencode success_url="https://example.com/success"

Si vous ne souhaitez pas collecter les adresses de livraison avec Checkout, vous pouvez également fournir l’adresse de livraison en utilisant payment_intent_data[shipping]. Cela permet d’améliorer les taux d’acceptation des prêts.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=5000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=affirm \
  -d "payment_intent_data[shipping][name]"="Jenny Rosen" \
  -d "payment_intent_data[shipping][address][line1]"="1234 Main Street" \
  -d "payment_intent_data[shipping][address][city]"="San Francisco" \
  -d "payment_intent_data[shipping][address][state]"=CA \
  -d "payment_intent_data[shipping][address][country]"=US \
  -d "payment_intent_data[shipping][address][postal_code]"=94111 \
  --data-urlencode success_url="https://example.com/success"

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.