Disclaimer: Some content in this article outlines how to use functionalities that will be publicly released to all clients in mid-July 2024. If you see differences between this article and your platform, check back at that time for updated content.
Disclaimer: The support of Stripe Tax is available on demand. For more details contact Docebo via the Help Center or through your Account Manager, if your plan includes this option.
Introduction
The Stripe Strong Customer Authentication (SCA) payment gateway is an authorized payment gateway on your platform.
Docebo integrates with Stripe SCA, which is compliant with all of the International credit card circuits and with the European regulatory requirement to reduce fraud and make online payments more secure. Learn more on Stripe SCA (opens in a new tab).
Stripe SCA manages the automated tax calculation via Stripe Tax (opens in a new tab), learn more in the Managing the tax calculation method chapter of this article.
Please Note: If the accurate calculation of taxes is a determining factor in the proper operation of your e-commerce business, it is highly recommended that you only enable Stripe SCA as your credit card transaction processor.
Requirements & limitations
- Configuring Stripe SCA in Docebo Learn requires that the E-commerce app is activated on your platform.
- Some currencies supported by Docebo may not be accepted by Stripe, so remember to check if your currency is supported by both systems before proceeding. Check out the complete list of the currencies supported by Docebo.
- When using Stripe Tax, please note that the tax calculation is available for the currencies and the Countries listed on StripeDOCS (opens in a new tab).
- When working with the Extended Enterprise, configure the settings of Stripe in the root domain. If some domains require a different configuration, apply the configuration locally, in the E-commerce tab of the Extended Enterprise app.
Use case scenarios
In the United States, prices do not include taxes, while in other countries it is the opposite. Stripe Tax does not explicitly support this diversification since whether taxes should be excluded or included is determined at the account level.
Since Stripe allows you to create multiple accounts and configure them independently and Docebo allows you to configure different payment gateways, one for each Extended Enterprise domain, you can create a domain for the United States market associated with a Stripe account excluding taxes and another domain for other countries associated with a Stripe account configured to include taxes. Optionally, for the second domain, it is possible to hide the "Taxes are calculated at checkout" text shown in the user's shopping cart using either custom CSS or the Localization tool.
Activating Stripe in your platform
Activate the Payment Method - Stripe SCA app as described in the Managing apps & features article of the knowledge base. The app is listed in the Third party integrations tab.
Configuring Stripe SCA in Docebo
In order to configure Stripe SCA in Docebo, log into your platform as the Superadmin, then access the Admin menu from the gear icon in the top right corner and select the Manage option in the Payment method - Stripe SCA section. Activate the Enable Stripe payment gateway toggle to enable this payment gateway in your platform.
Select the Use the real environment option and insert your Stripe account email, Live secret key and Live publishable key into the corresponding text boxes. In order to retrieve this information, access your Admin account in your Stripe Dashboard (opens in a new tab), go to the Developers tab on the top right corner and then to the API keys tab.
The publishable key and the secret key are available in the Standard Keys section. If you need help finding this information, refer to Stripe’s support area (opens in a new tab).
Copy those values in the corresponding fields of the Payment method - Stripe SCA page in Docebo and press Save changes to finalize the configuration.
In the Payment method - Stripe SCA page in Docebo, you can select the option to use a Sandbox instead of the live environment to perform any necessary testing. When this option is enabled, none of the payment operations will be billed to any account. In order to use the sandbox option, please fill the Test Secret Key and the Test Publishable Key fields that are displayed when the option is selected.
Managing the tax calculation method (Updated!)
When using Stripe SCA, you can either automate the tax calculation via Stripe Tax (opens in a new tab) or use the manual tax calculation. To configure the tax calculation method, move to the Payment type area of the Stripe SCA configuration page and select the Simple charge option for manual calculation or the Enable automatic tax calculation option for automatic calculation.
When the Simple charge option is selected, the completed payment transactions are listed in the Payments tab of your Stripe admin dashboard. This option requires no further configuration.
When the Enable automatic tax calculation option is selected:
- Stripe Tax automatically calculates and collects the taxes on all purchases (including subscriptions) performed via e-commerce. Learn more on StripeDOCS (opens in a new tab). The integration with Stripe Tax must be configured both on Stripe and on Docebo as described in the Configuring Stripe Tax chapter of this article.
- When users select Stripe SCA for their payments, they have select a Country among those supported by Stripe (opens in a new tab) using the Stripe supported countries dropdown. This field is mandatory.
Enable the option Authorize Stripe to send an invoice per transaction detailing the purchased items, to force Stripe to automatically send an invoice via email to the users who finalize a purchase on the platform. When this option is activated, users must fill in their email address in the Billing information panel of the Payment and billing step of the purchase process to finalize the purchase. The invoice will be sent only after a successful payment and will contain details of every item bought in the transaction. If users buy multiple quantities of the same item, each item will be listed separately on the invoice.
Configuring Stripe Tax
To configure Stripe Tax log in to your Admin account in Stripe (opens in a new tab), click on the gear icon in the header to access the Settings page and click on Settings in the Tax section.
Configure the available options as follows:
In the Business Information section, set the Origin address to where your business is located.
In the Product and Prices section select a Default product tax category. The most commonly used option is General - Electronically supplied services.
Use the Include tax in prices dropdown to select how taxes are presented to the buyer. The available options are:
-
- Yes - Tax is included in the price: the amount paid by buyers never changes, even if the tax rate varies.
- No - Tax is excluded from the price: taxes are specified on the price and added to the subtotal. This solution is common in US markets and for B2B sales.
- Automatic - Use the currency to determine if tax is included or excluded: use this option only if suggested by your tax consultant or by your Stripe CSM.
In the Automatic Tax Calculation section, enable the Use automatic tax calculation toggle.
More details on setting up Stripe Tax are available in StripeDOCS (opens in a new tab).
As a business, you have an obligation to identify the states or provinces and Countries where you have tax obligations and need to register to collect tax in the Registrations tab of the Application Dashboard that you can reach from the Application bar by clicking on More and then on Tax.
From this tab, click on Export transactions to export transaction data into either an itemized or summarized report, which can be used to integrate with other services for more organic management of taxes. Learn how to register for sales tax, VAT, and GST and how to export transactions on StripeDOCS (opens in a new tab).
Move back to the Payment method - Stripe SCA page on Docebo, and select the Enable automatic tax calculation option in the Payment type section and enter the Tax Code.
The most commonly used option is txcd_10000000 which represents any Electronically Supplied Service.
Best practices
Please pay attention to the following notes when integrating Stripe into your platform:
- When a user buys content using Stripe as a payment method, that user will be registered as a customer in Stripe and you will find their details in your Stripe Admin Dashboard.
- To complete the purchase, please note that the following data is mandatory: Address, City, and Country. If automatic tax collection is enabled (such as with Stripe Tax), the following data is mandatory: Address, City, Country, State/Province/Region, and ZIP/Postal code.
- The process for setting up the Stripe SCA configuration in your platform is identical when using either a single domain or Docebo’s Extended Enterprise functionality.