Guide de migration pour la SCA pour les plugins et les bibliothèques développeur
Comment mettre à jour votre bibliothèque développeur ou votre plugin Stripe pour la prise en charge de l'authentification forte du client (SCA).
Note
Ce guide consacré à la SCA est destiné aux développeurs de plugins ou de bibliothèques Stripe. Si vous êtes un utilisateur Stripe à la recherche d’un plugin prenant en charge la SCA, consultez la page Partenaires Stripe.
Dois-je prendre en charge la SCA pour mes utilisateurs ?
Les entreprises de l’Espace économique européen (EEE) qui acceptent des paiements en ligne de la part de clients de l’EEE ont besoin d’une expérience utilisateur différente, à savoir 3D Secure. Depuis le 14 septembre 2019, les transactions qui ne respectent pas les nouvelles directives d’authentification pourront être refusées par la banque du client. Ce niveau d’authentification supplémentaire nécessite une migration vers des solutions prêtes pour la SCA comme la nouvelle version de Checkout ou l’l’API Payment Intents, décrite à l’étape 2.
Identifier votre plugin sur notre plateforme
Les plugins et les bibliothèques tierces doivent inclure des informations d’identification afin que nous puissions vous contacter en cas de modifications futures ou de mises à jour critiques de l’API. Utilisez la fonction setAppInfo pour fournir ces informations dans votre intégration Stripe.
Nous vous encourageons à rejoindre le programme Partenaires Stripe. L’inscription est gratuite et vous y trouverez davantage de ressources destinées aux développeurs qui conçoivent des plugins. Prenez connaissance de nos recommandations de bonnes pratiques.
Déterminer votre chemin d'intégration
Reportez-vous à notre guide de migration pour la SCA afin de passer en revue les chemins d’intégration de la nouvelle version de Stripe Checkout, de l’API Payment Intents, de l’API Setup Intents, de Stripe Billing et d’iOS ou d’Android. Pour les développeurs de plugins ou de bibliothèques :
- Choisissez Stripe Checkout si possible. La nouvelle version Checkout de Stripe est une page de paiement entièrement hébergée qui peut être personnalisée avec la marque de l’entreprise, prend en charge les abonnements récurrents et constitue le moyen le plus simple de fournir une assistance SCA à vos utilisateurs.
- Pour davantage de contrôle sur votre expérience de paiement, utilisez les API Payment Intents et Setup Intents. Ces API fonctionnent avec nos Elements, les composants personnalisables de l’interface utilisateur de Stripe pour les tunnels de paiement, ainsi que d’autres API Stripe comme PaymentMethods, Customers et Connect. Les API Payment Intents et Setup Intents déclenchent des flux d’authentification, y compris de type 3D Secure 2, enregistrent les cartes pour permettre leur réutilisation ultérieure et vous garantissent une intégration prête pour la SCA.
- Abonnez votre utilisateur aux webhooks de manière programmatique : vous pouvez enregistrer un endpoint de webhook pour votre compte ou vos comptes connectés et les gérer via l’API Webhooks, ce qui simplifie la configuration pour vos utilisateurs.
Si aucune de ces options ne fonctionne pour votre intégration, veuillez nous le faire savoir.
Tester l'authentification dynamique
Une fois la nouvelle approche d’intégration implémentée, configurez vos règles Radar 3D Secure dynamique de façon à tester votre intégration à l’aide de vos cartes de test 3D Secure. Veillez à tester à la fois les cas de réussite et d’échec de l’authentification.
Informer vos utilisateurs et Stripe
Une fois votre solution de paiement prête pour la SCA, nous vous recommandons d’en informer vos utilisateurs. Vous pouvez partager notre guide pour la SCA avec vos utilisateurs pour les aider à comprendre ces évolutions réglementaires. À la publication de votre mise à jour prête pour la SCA, veuillez nous en informer également.
Mise en garde
Fournissez une version prenant en charge la SCA dès que vous avez terminé votre mise à niveau. Nous renvoyons les utilisateurs vers les solutions prêtes pour la SCA figurant sur la page Partenaires Stripe.