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.
L’acceptation d’Afterpay dans votre application consiste à afficher une vue Web permettant à votre client d’authentifier son paiement. Votre client retourne ensuite dans votre application et vous pouvez immédiatement confirmer si le paiement a abouti ou échoué.
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.
Configurer StripeCôté serveurCôté client
Tout d’abord, il vous faut un compte Stripe. Inscrivez-vous.
Côté serveur
Pour cette intégration, votre serveur doit être doté d’endpoints qui communiquent avec l’API Stripe. Utilisez les bibliothèques officielles pour accéder à l’API Stripe depuis votre serveur :
Côté client
Le SDK Stripe Android est disponible en open source et fait l’objet d’une documentation complète.
Pour installer le SDK, ajoutez stripe-android
au bloc dependencies
de votre fichier app/build.gradle :
Remarque
Pour obtenir de plus amples informations sur la version la plus récente du SDK et ses versions antérieures, consultez la page des versions sur GitHub. Pour savoir quand une nouvelle version est disponible, surveillez les versions du référentiel.
Configurez le SDK avec votre clé publique Stripe de façon à ce qu’il puisse envoyer des requêtes à l’API Stripe, par exemple à la sous-classe Application
:
Remarque
Utilisez vos clés de test lors de vos activités de test et de développement et vos clés du mode production pour la publication de votre application.
Les échantillons de code de Stripe utilisent également OkHttp et GSON pour envoyer des requêtes HTTP à un serveur.
Créez un PaymentIntentCôté serveurCôté client
Un PaymentIntent est un objet qui représente votre intention de collecter un paiement auprès d’un client et qui suit le cycle de vie du processus de paiement à chaque étape.
Côté serveur
Créez tout d’abord un PaymentIntent
sur votre serveur, puis indiquez le montant à encaisser ainsi que la devise. Si votre intégration inclut déjà l’API Payment Intents, ajoutez afterpay_
à la liste des types de moyens de paiement valides pour votre PaymentIntent
.
Options supplémentaires du moyen de paiement
Vous pouvez préciser un paramètre reference
facultatif dans les options des moyens de paiement pour votre PaymentIntent
qui définit un identifiant de commande interne pour le paiement. Bien que ces informations ne soient généralement pas visibles ni par l’entreprise ni par le consommateur, l’équipe d’assistance interne d’Afterpay peut y accéder lors des demandes d’assistance manuelles. L’identifiant est limité à 128 caractères et ne doit contenir que des lettres, des chiffres, des traits de soulignement, des barres obliques inversées et des tirets.
Côté client
Le PaymentIntent renvoyé contient une clé secrète du client, que vous pouvez envoyer au client pour une exécution sécurisée du processus de paiement au lieu de lui transmettre la totalité de l’objet PaymentIntent. Côté client, demandez un PaymentIntent auprès de votre serveur et sauvegardez la clé secrète du client.
Collectez les informations du moyen de paiementCôté client
Afterpay exige que les données de facturation soient présentes pour que le paiement aboutisse. Dans votre application, recueillez les informations de facturation requises auprès du client :
- Nom complet (nom et prénom)
- Adresse e-mail
- Adresse de facturation complète
Créez ensuite un objet PaymentMethodCreateParams avec ces données.
De plus, bien que les informations de livraison ne soient pas obligatoires, elles peuvent contribuer à améliorer les taux d’authentification. Pour collecter les informations de livraison, recueillez les renseignements suivants auprès du client :
- Nom complet
- Adresse de livraison complète
Créez ensuite un objet ConfirmPaymentIntentParams.Shipping avec ces données.
Envoyez le paiement à StripeCôté client
Récupérez la clé secrète du client auprès du PaymentIntent que vous avez créé à l’étape 2, puis appelez la méthode confirm de PaymentLauncher. Une page Web s’affiche, dans laquelle le client peut finaliser le paiement sur le site Web ou l’application de sa banque. Une fois l’opération terminée, onActivityResult est appelé avec le résultat du paiement.
É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. |