Avertissement sur la version sandbox : une partie du contenu de cet article décrit des fonctionnalités qui seront publiquement disponibles pour tous les clients fin avril 2026. Si vous observez des différences entre ce qui y est décrit et votre plateforme, contactez votre représentant Docebo pour découvrir comment profiter de ces fonctionnalités. En savoir plus sur le cycle de publication.

Introduction

La passerelle de paiement Stripe Strong Customer Authentication (Stripe SCA) est un moyen de paiement autorisé pouvant être utilisé avec les fonctionnalités e-commerce de votre plateforme.

Stripe SCA est conforme à tous les circuits internationaux de cartes de crédit, ainsi qu’aux exigences réglementaires européennes visant à réduire la fraude et à sécuriser les paiements en ligne. 

L’intégration de Stripe dans Docebo prend en charge deux composants :

• Stripe SCA, la passerelle de paiement principale pour le traitement des paiements. En savoir plus sur Stripe SCA (s’ouvre dans un nouvel onglet).
• Stripe Tax, un outil supplémentaire qui automatise le calcul des taxes et la conformité pour les entreprises vendant des produits ou services dans diverses juridictions fiscales. En savoir plus sur Stripe Tax (s’ouvre dans un nouvel onglet).

Si vous avez uniquement besoin de gérer des paiements, Stripe se suffit à lui seul. Mais si vous devez gérer une conformité fiscale complexe, notamment pour des ventes internationales ou inter-états, Stripe Tax peut simplifier considérablement ce processus.

Cet article explique comment configurer l’intégration avec Stripe sur votre plateforme, ainsi que la fonctionnalité Stripe Tax, le cas échéant.

À noter : si le calcul précis des taxes est un facteur déterminant dans le bon fonctionnement de votre activité e-commerce, il est fortement recommandé d’utiliser uniquement Stripe SCA avec Stripe Tax pour le traitement des transactions par carte de crédit.

Prérequis

L’intégration Stripe SCA et l’extension Stripe Tax sont disponibles sur la plateforme avec le pack e-commerce. Contactez votre représentant Docebo pour découvrir comment l’obtenir. 

• Pour configurer cette intégration, vous devez avoir un accès administrateur à un compte Stripe valide.

Conditions et limitations

• Certaines devises prises en charge par Docebo peuvent ne pas être acceptées par Stripe, pensez donc à vérifier si votre devise est acceptée par les deux systèmes avant de poursuivre. Consultez la liste complète des devises prises en charge par Docebo.
• Si vous utilisez l’application Extended Enterprise, configurez les paramètres de Stripe dans le domaine racine. Si certains domaines nécessitent une configuration différente, appliquez-la localement, dans l’onglet E-commerce de l’application Extended Enterprise.
• Si vous utilisez Stripe Tax :
  • Veuillez noter que le calcul des taxes est disponible pour les devises et pays figurant dans la documentation de Stripe (ouvre dans un nouvel onglet)
  • Dans le cas des abonnements, le calcul automatique des taxes est pris en charge pour les achats et les renouvellements. Cependant, notez que les factures ne sont disponibles que pour les achats d’abonnement, pas pour les renouvellements.
  • Au passage en caisse, la plateforme affichera toujours les taxes séparément du prix, même si vous avez choisi l’option d’inclure les taxes dans le prix dans Stripe Tax.

Cas d’usage

Aux États-Unis, les prix n’incluent pas les taxes, tandis que dans d’autres pays c’est l’inverse. Stripe Tax ne prend pas explicitement en charge cette distinction, car la décision de les exclure ou de les inclure est déterminée pour chaque compte.

Puisque Stripe vous permet de créer plusieurs comptes et de les configurer indépendamment, et que Docebo vous permet de configurer différentes passerelles de paiement (une par domaine Extended Enterprise), vous pouvez créer un domaine pour le marché américain associé à un compte Stripe excluant les taxes, et un autre pour d’autres pays associé à un compte Stripe configuré pour inclure les taxes. Sur ce second domaine, il est également possible de masquer le texte "Les taxes sont calculées au moment du paiement" affiché dans le panier de l’utilisateur, en utilisant soit un CSS personnalisé, soit l’outil de localisation.

Configurer la passerelle de paiement Stripe SCA

Pour configurer Stripe SCA sur la plateforme, connectez-vous en tant que Superadmin, puis sélectionnez Menu admin > Moyen de paiement - Stripe SCA > Gérer. Sur la page de configuration qui s’ouvre, activez l’option Activer la passerelle de paiement Stripe. 

Dans le champ Informations Stripe, saisissez l’email de votre compte Stripe. Puis continuez pour Saisir vos clés Stripe, Configurer l’activation de Klarna, et Configurer les options de prélèvement pour le calcul des taxes.

Saisir vos clés Stripe

Dans la section Environnement de test, sélectionnez si vous souhaitez utiliser une sandbox (environnement de test) ou un environnement réel (live). Avec l’option sandbox, aucune opération de paiement ne sera facturée sur un compte.

Ensuite, saisissez la Clé secrète et la Clé publiable pour l’environnement choisi (test ou live).
Pour récupérer ces clés depuis Stripe :

1.  Accédez au Tableau de bord Stripe (ouvre dans un nouvel onglet) avec votre compte administrateur.  
2. Dans l’angle supérieur droit, sélectionnez Developers (Développeurs), puis sur l’onglet API keys (Clés API).
3. Activez l’option View test data (Afficher les données de test) si vous souhaitez récupérer les clés pour l’environnement de test. Sinon, laissez-la désactivée pour obtenir les clés live.
4. La clé publique et la clé secrète sont disponibles dans la section Standard keys (Clés standard). Si vous avez besoin d’aide pour trouver ces informations, consultez l’espace d’assistance de Stripe (ouvre dans un nouvel onglet).
   

Configurer l’activation de Klarna

Dans la section Type de paiement, sous Autre moyen de paiement, définissez si vous souhaitez activer l’option de paiement en plusieurs fois pour les utilisateurs payant via Stripe. Notez que : 

• Les acheteurs devront sélectionner « Stripe » comme passerelle de paiement dans le panier. Ils seront ensuite redirigés vers la page de paiement Stripe où ils verront l’option Klarna*.
  → *L’option Klarna peut ne pas être disponible en cas d’incompatibilité entre la devise utilisée pour le paiement et le pays du commerçant sur Stripe.
• Si cette option est activée, Klarna paiera la totalité du montant au commerçant, puis débitera les échéances sur la carte de crédit de l’acheteur.
• La page de la transaction E-commerce et le rapport sur la transaction afficheront uniquement « Stripe » comme moyen de paiement utilisé, sans mention de l’utilisation de Klarna.

Pour activer Klarna : 
Cochez la case Activer Klarna.
→ N’oubliez pas que la configuration Klarna que vous choisissez ici s’appliquera automatiquement à tous les clients extended enterprise ayant Stripe SCA activé. Vous ne pouvez pas l’activer ou la désactiver sélectivement sur des domaines spécifiques.

Vous devez également activer Klarna dans votre tableau de bord Stripe. Pour en savoir plus, consultez la documentation de Stripe relative aux paiements avec Klarna (s’ouvre dans un nouvel onglet).

À noter : lorsque vous activez Klarna, l’intégration avec la plateforme impose les paramètres par défaut pour cette option, écrasant toute potentielle configuration personnalisée définie dans Stripe.

Configurer les options de prélèvement pour le calcul des taxes

Dans la section Type de paiement, si vous n’avez pas besoin de Stripe Tax (calcul automatique des taxes), vous pouvez laisser l’option Option de prélèvement sur la valeur par défaut, Frais simple.

Pour configurer Stripe Tax, complétez les étapes décrites dans le chapitre Configurer le calcul automatique des taxes.

Une fois que vous avez terminé, cliquez sur Enregistrer les modifications.

Configurer le calcul automatique des taxes avec Stripe Tax

Stripe Tax est un outil supplémentaire de la passerelle de paiement Stripe qui prend en charge le calcul automatique des taxes :

• Stripe Tax calcule et collecte automatiquement les taxes sur tous les achats électroniques effectués (y compris les achats et renouvellements d’abonnements). En savoir plus sur StripeDOCS (s’ouvre dans un nouvel onglet). 
• Lorsque les utilisateurs choisissent Stripe SCA pour leur paiement, dans la section Informations de facturation lors du passage en caisse, ils doivent indiquer s’ils sont une entreprise ou un particulier :  Les acheteurs professionnels doivent saisir un nom d’entreprise et un numéro de TVA, tandis que les particuliers doivent saisir leur nom complet et peuvent également fournir un identifiant fiscal. 
• De plus, tous les types d’utilisateurs doivent saisir leur adresse email, adresse postale, ville et code postal, et sélectionner leur pays dans la liste déroulante de ceux pris en charge par Stripe (consultez-en la liste (s’ouvre dans un nouvel onglet)). Ces informations sont utilisées pour le calcul des taxes.

Pour configurer cette fonctionnalité, vous devez activer le calcul automatique des taxes sur la plateforme, ainsi que configurer Stripe Tax dans le tableau de bord Stripe, comme décrit dans les chapitres suivants. 

Activer le calcul automatique des taxes sur la plateforme

→ Cette procédure suppose que la passerelle de paiement principale Stripe SCA est déjà configurée. 

Sélectionnez Menu admin > Moyen de paiement - Stripe SCA > Gérer, puis sur la page de configuration de Stripe, descendez à la section Type de paiement et cochez l’option Activer le calcul automatique des taxes. 

• Dans le champ Code fiscal, saisissez le code fiscal produit que vous souhaitez appliquer. Cela déterminera le taux de taxe appliqué à vos transactions. Par exemple txcd_10000000 (Général - Services électroniques). Référez-vous à la documentation de Stripe sur les codes fiscaux (s’ouvre dans un nouvel onglet). 
• Activez l’option Autoriser Stripe à envoyer une facture par transaction détaillant les articles achetés, pour permettre à Stripe d’envoyer automatiquement une facture par e-mail aux utilisateurs finalisant un achat sur la plateforme. 

À noter : l’envoi de ces emails de facturation doit également être configuré côté Stripe.
Lorsque cette option est activée, les utilisateurs doivent saisir leur adresse e-mail dans le panneau Informations de facturation de l’étape Paiement et facturation pour finaliser la transaction. La facture sera envoyée uniquement après un paiement réussi et contiendra les détails de chaque article acheté dans la transaction. Si les utilisateurs achètent plusieurs quantités du même article, chaque article figurera séparément sur la facture. 
Pour les professionnels, la facture inclura le numéro de TVA, tandis que pour les particuliers, elle inclura l’identifiant fiscal si cette information a été fournie. 
Pour les abonnements : notez que la facture est disponible uniquement pour l’achat initial de l’abonnement, pas pour les renouvellements suivants.

Lorsque vous avez terminé, cliquez sur Enregistrer les modifications. 

→ N’oubliez pas que vous devez également compléter la configuration côté Stripe comme décrit dans le chapitre suivant, Configurer Stripe Tax dans le tableau de bord Stripe. 

Configurer Stripe Tax dans le tableau de bord Stripe (Mis à jour !)

Connectez-vous au tableau de bord Stripe avec vos identifiants administrateur (s’ouvre dans un nouvel onglet), cliquez sur l’icône d’engrenage dans l’en-tête pour ouvrir la page Product settings (Paramètres du produit), puis dans la section Tax (Taxes), sélectionnez Settings (Paramètres).

Configurez les options disponibles comme suit :

Dans la section Business information (Informations sur l’entreprise), définissez l’Origin address (Adresse d’origine) où est située votre entreprise.

Dans la section Product and prices (Produit et prix), sélectionnez une Catégorie fiscale par défaut pour le produit (Default product tax category). L’option la plus courante est General - Electronically Supplied Services (Général - Services électroniques). 

Le menu déroulant Include tax in prices (Inclure les taxes dans les prix) détermine comment taxes sont présentées à l’acheteur. Les options disponibles sont :

• Yes - Tax is included in the price (Oui - La taxe est incluse dans le prix) : le montant payé par les acheteurs ne change jamais, même si le taux de taxe varie.
• No - Tax is excluded from the price (Non - La taxe est exclue du prix) : les taxes sont spécifiées sur le prix et ajoutées au sous-total. Cette solution est courante sur les marchés américains et pour les ventes B2B.
• Automatic - Use the currency to determine if tax is included or excluded (Automatique - Utiliser la devise pour déterminer si la taxe est incluse ou exclue) : utilisez cette option uniquement si elle est suggérée par votre conseiller fiscal ou votre CSM Stripe.

Dans la section Automatic tax calculation (Calcul automatique des taxes), activez le bouton bascule Use automatic tax calculation (Utiliser le calcul automatique des taxes).

Plus de détails sur la configuration de Stripe Tax sont disponibles dans StripeDOCS (ouvre dans un nouvel onglet).

En tant qu’entreprise, vous avez l’obligation d’identifier les États, provinces et pays vis-à-vis desquels vous avez des obligations fiscales, et devez vous enregistrer pour la collecte des taxes dans l’onglet Registrations (Enregistrements) du tableau de bord (Application dashboard) accessible depuis la barre d’application en cliquant sur More (Plus) puis sur Tax (Taxe).

Depuis cet onglet, cliquez sur Export transactions (Exporter les transactions) pour exporter les données de transaction sous forme de rapport détaillé ou résumé. Celui-ci pourra être utilisé pour intégrer d’autres services, afin d’assurer une gestion plus fluide des taxes. Apprenez comment vous enregistrer pour la taxe à la vente, la TVA et la TPS ainsi que comment exporter les transactions sur StripeDOCS (s’ouvre dans un nouvel onglet).

Meilleures pratiques

Veuillez tenir compte des remarques suivantes lors de l’intégration de Stripe avec votre plateforme :

• Lorsqu’un utilisateur achète du contenu en utilisant Stripe comme moyen de paiement, cet utilisateur sera enregistré en tant que client dans Stripe et vous trouverez ses informations dans votre tableau de bord administrateur Stripe.
• Le processus de configuration de Stripe SCA sur votre plateforme est identique que vous utilisiez un domaine unique ou la fonctionnalité Extended Enterprise de Docebo.