Accepter un paiement avec Alma
Découvrez comment configurer votre intégration avec Alma.
Pour ajouter Alma et d’autres moyens de paiement à votre intégration le plus facilement possible, utilisez le composant Mobile Payment Element, un formulaire de paiement intégrable.
Alma est un moyen de paiement à usage unique permettant aux clients de payer en 2, 3 ou 4 versements échelonnés. Les clients sont redirigés depuis votre site Web ou votre application, autorisent le paiement avec Alma, puis retournent sur votre site Web ou votre application. Vous recevez une notification immédiate indiquant si le paiement a réussi ou échoué.
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éer un PaymentIntentCôté serveurCôté client
Côté serveur
Un PaymentIntent est un objet qui représente votre intention d’encaisser le paiement d’un client et qui suit le cycle de vie du processus de paiement étape par étape.
Mise en garde
Définissez toujours le montant à débiter côté serveur car il s’agit d’un environnement sécurisé, contrairement à l’environnement client. De cette façon, les client ne pourront pas fixer leurs propres tarifs.
Côté client
Côté client, demandez un PaymentIntent auprès de votre serveur et stockez la clé secrète du client.
Envoyer le paiement à StripeCôté client
Lorsqu’un client appuie sur le bouton de paiement avec Alma, confirmez le PaymentIntent
pour finaliser le paiement. Configurez un objet ConfirmPaymentIntentParams
avec la clé secrète du client du PaymentIntent
.
La clé secrète du client est différente de vos clés API qui authentifient les requêtes API de Stripe. Elle doit être utilisée avec prudence car elle peut servir à effectuer un 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 Alma
Finalisez le paiement en appelant PaymentHandler.
. Une vue Web s’affiche pour permettre au client d’effectuer le paiement avec Alma. Après confirmation, Stripe appelle le bloc de finalisation avec le résultat du paiement.
Devises prises en charge
Vous pouvez créer des paiements Alma dans les devises correspondant à votre pays. La devise locale par défaut pour Alma est eur
, et les clients voient également le montant de leur achat en eur
.
Devise | Pays |
---|---|
eur | France, Italie, Espagne, Pays-Bas, Belgique, Luxembourg |