Paiements SwishSur invitation uniquement
Comment accepter Swish, un moyen de paiement populaire en Suède.
Swish est un moyen de paiement à usage unique utilisé en Suède. Il permet aux clients d’authentifier et approuver leurs paiements via l’application mobile Swish et l’application mobile suédoise BankID.
Vous recevez une notification immédiate indiquant si le paiement a abouti ou échoué.
Déclarations obligatoires
Pour respecter les règles de Swish, vous devez afficher le texte suivant dans votre tunnel de paiement à l’écran avant que le client n’autorise le paiement Swish :
- Pour les localisations en anglais : « Stripe Technology Europe Limited (“Stripe”) has acquired the claim for payment. Therefore your payment will be made to Stripe. »
- Pour les localisations en suédois : « Stripe Technology Europe Limited (“Stripe”) har övertagit fordran på betalning. Din betalning görs därför till Stripe ».
- Pour les autres langues, une traduction équivalente du texte ci-dessus.
Si vous intégrez Swish via un formulaire de paiement ou un composant d’interface utilisateur hébergé par Stripe, tel que Checkout ou le Payment Element, Stripe affiche cet avis pour vous.
Nous vous recommandons d’utiliser le composant Mobile Payment Element, un formulaire de paiement intégrable, pour ajouter Swish (et d’autres moyens de paiement) à votre intégration le plus facilement possible.
Ce guide explique comment accepter les paiements Swish depuis votre application mobile native à l’aide de votre propre formulaire de paiement personnalisé.
Si vous acceptez les paiements Swish depuis votre application mobile native, vos clients sont redirigés vers l’application mobile Swish pour authentification. Le paiement est authentifié lors de la redirection. La finalisation de l’achat ne nécessite aucune action supplémentaire dans l’application mobile Swish. Le client est ensuite redirigé vers votre site.
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.
To install the SDK, add stripe-android
to the dependencies
block of your app/build.gradle file:
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
Les échantillons de code de Stripe utilisent également OkHttp et GSON pour envoyer des requêtes HTTP à un serveur.
Créer un PaymentIntentCôté serveurCôté client
Côté serveur
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.
Pour créer et confirmer un PaymentIntent
sur votre serveur :
- Indiquez le montant à encaisser et la devise.
- Ajoutez
swish
à la liste des types de moyens de paiement pour votrePaymentIntent
. Assurez-vous que Swish est activé dans le Dashboard. - Définissez
payment_
surmethod_ data[type] swish
pour créer un PaymentMethod et l’utiliser immédiatement avec ce PaymentIntent.
Le PaymentIntent renvoyé contient la clé secrète du client, que vous utiliserez pour confirmer le PaymentIntent. Renvoyez cette clé secrète côté client pour permettre son utilisation à l’étape suivante.
Côté client
Côté client, demandez un PaymentIntent auprès de votre serveur et sauvegardez la clé secrète du client qu’il contient.
Envoyer le paiement à StripeCôté client
Lorsqu’un client appuie sur le bouton de paiement avec Swish, confirmez le PaymentIntent
pour finaliser le paiement. Configurez un objet ConfirmPaymentIntentParams
avec la clé secrète du client du PaymentIntent
.
La clé secrète est différente de vos clés API qui servent à authentifier les requêtes de l’API Stripe. Elle doit être utilisée avec prudence, car elle peut servir à réaliser le paiement. Ne l’enregistrez pas, ne l’intégrez pas dans des URL et ne la dévoilez à personne d’autre que votre client.
Confirmer le paiement Swish
Pour terminer le paiement, appelez la méthode confirm de PaymentLauncher. Une page Web s’affiche dans laquelle le client peut finaliser le paiement avec Swish. Une fois l’opération terminée, le PaymentResultCallback
fourni est appelé avec le résultat du paiement.
Échecs de paiement
Swish utilise plusieurs données pour décider du refus d’une transaction (par exemple, s’il n’y a pas assez de fonds sur le compte bancaire du client ou si ce dernier a cliqué sur Annuler dans l’application).
Dans ce cas, le PaymentMethod est détaché et le statut de l’objet PaymentIntent passe automatiquement à requires_
Hormis le refus d’un paiement, dans le cas d’un PaymentIntent Swish à l’état requires_
, les clients doivent effectuer le paiement sous 3 minutes. En l’absence d’action sous 3 minutes, le PaymentMethod est détaché et l’état de l’objet PaymentIntent passe automatiquement à requires_
.