Accepter un paiement Afterpay ou Clearpay
Comment accepter Afterpay (aussi connu sous le nom de Clearpay au Royaume-Uni), un moyen de paiement utilisé aux États-Unis, au Canada, au Royaume-Uni, en Australie, et en Nouvelle-Zélande.
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.
Afterpay est un moyen de paiement à usage unique et à notification immédiate pour lequel le client doit authentifier son paiement. Les clients sont redirigés vers le site d’Afterpay, sur lequel ils acceptent les conditions d’un plan de versements échelonnés. Une fois que le client a accepté les conditions, Afterpay garantit la disponibilité des fonds et les transfère vers votre compte Stripe. Le client rembourse directement Afterpay au fil du temps.
Remarque
Avant de commencer l’intégration, assurez-vous que votre compte est admissible à Afterpay 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 Afterpay :
- Vous ne pouvez utiliser que des postes ponctuels (les postes récurrents dans le cadre de plans d’abonnement ne sont pas pris en charge).
- 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 Afterpay et découvrir les différences entre l’acceptation d’un paiement par carte bancaire et l’utilisation d’Afterpay.
Activer le moyen de paiement Afterpay
Lors de la création d’une nouvelle session Checkout, vous devez :
- Ajouter
afterpay_
à la listeclearpay payment_
method_ types - Veiller à ce que tous vos
line_
utilisent votre devise locale.items - Nous vous recommandons de collecter les adresses de livraison en ajoutant votre pays au paramètre
shipping_
. Si vous ne souhaitez pas collecter l’adresse de livraison avec Checkout, vous pouvez également la fournir à l’aide deaddress_ collection[allowed_ countries] payment_
. Ces informations sont utiles pour le calcul des taux d’approbation de prêt.intent_ data[shipping]
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énement | Description | Étapes suivantes |
---|---|---|
checkout.session.completed | Le client a autorisé le paiement en envoyant le formulaire Checkout. | Attendez que le paiement aboutisse ou échoue. |
payment_intent.succeeded | Le paiement du client a abouti. Le PaymentIntent bascule à l’état succeeded . | Traitez la commande de biens ou de services de votre client. |
payment_intent.payment_failed | Le paiement du client a été refusé, ou le paiement a échoué pour un autre motif. Le PaymentIntent revient à l’état requires_ . | Contactez votre client par e-mail et demandez-lui de passer une nouvelle commande. |
En savoir plus sur le traitement des commandes.
Tester votre intégration
Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement Afterpay, puis cliquez sur le bouton Payer.
Testez votre intégration Afterpay 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 passera alors de l’état requires_
à 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, cliquez sur Échec du paiement test. Votre PaymentIntent bascule alors de l’état requires_
à requires_
.
Pour les PaymentIntents à capture manuelle en mode test, le PaymentIntent non capturé expirera automatiquement 10 minutes après l’aboutissement de l’autorisation.
Échecs de paiement
Afterpay prend en compte de nombreux facteurs pour accepter ou décliner une transaction (par exemple, la durée d’utilisation d’Afterpay par le client, le montant restant que le client doit rembourser, ou encore la valeur de la commande actuelle).
Vous devez toujours présenter des options de paiement supplémentaires telles que card
dans votre tunnel de paiement, car les paiements Afterpay ont un taux de refus supérieur aux autres moyens de paiement. Dans ces cas, le PaymentMethod est dissocié et l’état de l’objet PaymentIntent passe automatiquement à requires_
.
Pour un PaymentIntent Afterpay portant l’état requires_
, les clients doivent effectuer le paiement dans les 3 heures suivant leur redirection vers le site d’Afterpay (ceci ne s’applique pas aux paiements refusés). Si aucune action n’est effectuée dans ce délai de 3 heures, le PaymentMethod est dissocié et l’état de l’objet PaymentIntent passe automatiquement à requires_
.
Dans ces 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’erreur | Action recommandée |
---|---|
payment_ | Erreur générique indiquant l’échec du paiement Afterpay. Il peut également s’agir d’un refus qui n’apparaît pas sous la forme d’un code d’erreur de refus. |
payment_ | Afterpay a refusé le paiement du client. Le client doit désormais contacter Afterpay pour obtenir plus d’informations. |
payment_ | Le client n’a jamais effectué le paiement sur la page de paiement d’Afterpay et la session a expiré. Stripe fait automatiquement expirer les Payment Intents qui n’ont pas été autorisés 3 heures après la création de la session de paiement. |
payment_ | Afterpay a rencontré une erreur liée au service et n’est pas en mesure de répondre à la demande. Réessayez ultérieurement. |
amount_ | Saisissez un montant compris dans les limites de transaction par défaut d’Afterpay pour chaque pays. |
amount_ | Saisissez un montant compris dans les limites de transaction par défaut d’Afterpay pour chaque pays. |