Configuring Stripe for the E-Commerce App

Learn how to configure Stripe and Stripe SCA as a payment gateway in your platform

Last Updated

April 21st, 2020

Docebo Module

Integrations

Reading Time

6 min

User Level

Introduction

The Stripe payment gateway is an authorized payment gateway on your platform. Please note that configuring Stripe in Docebo requires that the E-Commerce app is activated in your platform. 

There are two ways to configure Stripe in your platform:

  • Stripe Standard. The Docebo integration with standard Stripe.
  • Stripe SCA. The new version of Stripe, compliant also with the new European regulatory requirement to reduce fraud and make online payments more secure, called SCA: Strong Customer Authentication. This version is highly recommended for all of the merchants selling in Europe but we suggest you move to the Stripe SCA version even if you do not sell in the European market unless you are using Stripe Order (deprecated by Stripe) or Alipay which are both not supported by Stripe SCA. Refer to this article on the Stripe support website for further information on SCA. 

Please note that Stripe Standard and Stripe SCA process payments in the same way, so users will have the same payment experience, though they may notice some small differences in the checkout processes. 

Please note that 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. Find here the complete list of the currencies supported by Docebo.

Configuring Stripe Standard and Stripe SCA in Docebo

Start configuring Stripe Standard and Stripe SCA by logging into your platform as the Superadmin, then access the Admin Menu from the gear icon in the top right corner of your platform. Move to the E-Commerce section, and click on Manage

Either select the Stripe Standard or the Stripe SCA tab, depending on your needs.

Configuring Stripe SCA in Docebo

In order to configure Stripe SCA, move to the corresponding tab and Enable Stripe payment gateway option at the top in order to activate the parameters needed for the configuration.

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 Stripe, then select the Developers tab on the left, and select API Keys. The publishable key and the secret key are available in the Standard Key section. If you need help finding this information, refer to Stripe’s support area.

If desired, you can flag the option to use a sandbox instead of the live environment to check for bugs and perform any necessary testing. In this testing phase, none of the payment operations will be billed to any account. In order to use the sandbox option, please fill the secret key and the publishable key fields that appear below the option, when flagged. Press Save Changes to finalize the configuration. 

Configuring Stripe Standard in Docebo

In order to configure Stripe Standard, move to the corresponding tab and enable the Stripe Payment option at the top in order to activate the parameters needed for the configuration. Choose the Payment Type: either Simple Charge or Stripe Order. Please refer to the corresponding sections in this article to learn more about these options.

When configuring Stripe Standard, you can enable the AliPay option, but please note it only works if you have configured AliPay and Stripe Standard together outside of Docebo. 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 Stripe, then select the Developers tab on the left, and select API Keys. The publishable key and the secret key are available in the Standard Key section. If you need help finding this information, refer to Stripe’s support area.

If desired, you can flag the option to use a sandbox instead of the live environment to check for bugs and perform any necessary testing. In this testing phase, none of the payment operations will be billed to any account. In order to use the sandbox option, please fill the secret key and the publishable key fields that appear below the option, when flagged.

Stripe Standard: Payment Type Options

When using Stripe Standard, you can select either the simple charge or stripe order payment type.

  • Simple Charge. A simple payment will be completed by the user during the payment process, meaning that when the payment transaction is completed, you will see the transaction appear in the Payments section of your Stripe Admin Dashboard. This option requires no further configuration in your platform or in Stripe.
  • Stripe Order. Taxes can be applied during the transaction process. This option also provides a more detailed transaction history. There are three different ways to configure this option, one of them requiring that you enter the tax code into the text box that appears below the option (if you are using a third-party tax provider). Read below how to configure each option. Please note that Stripe Order has been deprecated by Stripe, refer to this article of the Stripe knowledge base for further information. 

Stripe Standard: Tax Included Payment Type

If you want all of your payment transactions from your Docebo platform to have a fixed tax included in the payment, you can set this option in Stripe. Access your Admin account in Stripe, then select the Settings tab on the left. In the Business Settings area, click on Orders. Press the Change Tax button in the Taxes area. In the Type dropdown menu, select Included, then press Update to confirm.

Now, when a user completes a payment, you will see the transaction in the Orders tab in your Stripe Admin Dashboard. When you open the details page for each transaction in the list, you will see the tax amount and description, among other details.

Stripe Standard: Fixed Tax Percentage Payment Type

If you want all of your payment transactions from your Docebo platform to have a fixed tax percentage, you can set the percentage in Stripe Standard. Access your Admin account in Stripe, then select the Settings tab on the left. In the Business Settings area, click on Orders. Press the Change Tax button in the Taxes area. In the Type dropdown menu, select Percentage. Add the percentage and description into the corresponding text boxes, then press Update to confirm.

Now, when a user completes a payment, you will see the transaction in the Orders tab in your Stripe Admin Dashboard. When you open the details page for each transaction in the list, you will see the tax amount and description, among other details.

Stripe Standard: Third-Party Tax Provider Payment Type

If you want all of your platform payment transactions to use a third-party tax provider that you’ve set up in your Stripe account, you can do so in your Stripe Admin Dashboard. Access your Admin account in Stripe, then select the Settings tab on the left. In the Business Settings area, click on Orders. Press the Change Tax button in the Taxes area. In the Type dropdown menu, select Provider. Select the provider from the dropdown menu then press Update to confirm.

Now, when a user completes a payment, you will see the transaction in the Orders tab in your Stripe Admin Dashboard. When you open the details page for each transaction in the list, you will see the tax amount, among other details. Please remember that for this type of payment, you need to enter the tax code into the Stripe configuration page in your platform. Refer to this link to learn how to retrieve your tax code.

Best Practices

Please pay attention to the following notes when integrating Stripe in your platform:

  • Every time a user buys a course in your platform using Stripe for payment, that user will be registered as a customer in Stripe. You can find customer information in your Stripe Admin Dashboard. When a buyer is purchasing a course in the platform, state and zip code address information is mandatory in order to determine tax jurisdictions.
  • Coupons that are created within Stripe can be applied to Stripe transactions. Once a Stripe coupon is applied in the platform, you can find the coupon details in the Orders area of your Stripe Admin Dashboard. On the transaction’s details page, you will see the coupon information in the Discount line.
  • Taxes applied by Stripe or a third-party provider will not appear on your platform interface during the checkout process in Docebo. Rather, just the price of the object will appear in the platform during the transaction. To see taxes applied during the transaction, you can find the details in the Orders area of your Stripe Admin Dashboard. On the transaction’s details page, you will see the tax information in the Taxes line.
  • The process for setting up this payment gateway in your platform is identical when using either a single domain or Docebo’s Extended Enterprise functionality.

This integration does support the Callback tax option for those that select the Stripe Order payment type.