Paiements VippsVersion bêta privée
Pour comprendre comment accepter les paiements Vipps, un moyen de paiement très répandu en Norvège.
Vipps est un portefeuille électronique à usage unique utilisé en Norvège. Il permet à votre client d’authentifier et d’approuver ses paiements à l’aide de l’application Vipps.
Lorsque votre client paie avec Vipps, Stripe effectue une transaction par carte à l’aide des données de carte que nous recevons de Vipps. Le traitement de la transaction par carte est invisible pour votre intégration, et Stripe vous informe immédiatement de la réussite ou de l’échec du paiement.
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.
Ce guide explique comment activer Vipps sur Checkout, notre formulaire de paiement hébergé, et vous montre les différences entre accepter un paiement par carte et accepter un paiement Vipps.
Déterminer la compatibilité
Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements Vipps :
- Les tarifs de tous les postes doivent être exprimés en couronnes norvégiennes (code de devise
NOK
).
Configurer StripeCôté serveur
Tout d’abord, vous avez besoin d’un compte Stripe. S’inscrire maintenant.
Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :
Accepter un paiement
Remarque
Ce guide s’appuie sur l’intégration de base Checkout permettant d’accepter un paiement.
Activer le moyen de paiement Vipps
Lors de la création d’une nouvelle session Checkout, vous devez :
- Renseignez l’en-tête d’aperçu
vipps_
avec votre version API lors des requêtespreview=v1 - Ajouter
vipps
à la liste des moyens de paiementpayment_
method_ types - Vérifier que tous vos postes
line_
sont exprimés dans la deviseitems nok
Traiter vos commandes
Maintenant que vous savez accepter des paiements, découvrez comment traiter les commandes.
Gérer les événements post-paiement
Stripe envoie un événement payment_intent.succeeded à l’issue du paiement. Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.
Plutôt que d’attendre un rappel de votre client, écoutez ces événements. En effet, côté client, l’acheteur pourrait fermer la fenêtre de son navigateur ou quitter l’application avant l’exécution du rappel. Des personnes malveillantes peuvent en profiter pour manipuler la réponse. Si vous configurez votre intégration de manière à écouter les événements asynchrones, cela vous permettra également d’accepter de nouveaux moyens de paiement plus facilement à l’avenir. Apprenez-en davantage sur les différences entre les différents moyens de paiement pris en charge.
Manuellement
Utilisez le Dashboard Stripe pour consulter tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements et relancer les paiements ayant échoué.
Code personnalisé
Créez un gestionnaire de webhooks pour écouter des événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhooks en local, grâce à la CLI Stripe.
Applications préconfigurées
Intégrez une application partenaire pour gérer les événements métier courants, comme l’automatisation, le marketing ou les ventes.
Tester l'intégration
Pour tester votre intégration dans un environnement de test, cela vous redirige vers une page de paiement test, dans laquelle vous pouvez autoriser ou refuser le paiement test.
En mode production, saisissez le numéro de téléphone associé à Vipps pour envoyer une notification push à votre application mobile Vipps. Vous pouvez autoriser ou refuser le paiement dans l’application mobile Vipps.
Échecs de paiement
Les transactions Vipps peuvent échouer si la transaction par carte sous-jacente est refusée. En savoir plus sur les refus de paiement par carte. Dans ce cas, le PaymentMethod est dissocié et l’état du PaymentIntent passe automatiquement à requires_
.
Lorsque l’état du PaymentIntent est requires_
, votre client doit authentifier le paiement dans les 5 minutes. Si aucune action n’est effectuée au bout de 5 minutes, le PaymentMethod est dissocié et l’état du PaymentIntent passe automatiquement à requires_
.
Remboursements et litiges
Stripe effectue une transaction par carte à l’aide de rails de paiement par carte standard dans le cadre d’une transaction Vipps. Les remboursements et les litiges sont soumis aux règles des réseaux Visa et Mastercard.