How to Configure Stripe in your Docebo LMS

By integrating your Docebo LMS with Stripe, you can add an additional payment gateway for your learners that are buying courses via Docebo’s E-Commerce Module.

Last Updated

February 12th, 2019

Reading Time

5 min

User Level

Introduction

By integrating your Docebo LMS with Stripe, you can add an additional payment gateway for your learners that are buying courses via Docebo’s E-Commerce Module. This article will explain how to set up the configuration in your LMS and how to manage Stripe’s tax calculation for your LMS.

Please note that you must have the E-Commerce Module activated in your Docebo platform for this configuration. This integration applies to those using Docebo 6.8 or higher.

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.

Accessing the Stripe Configuration Page in Docebo

Access the Admin Menu from the menu bar. In the E-Commerce section, select the Settings subitem. On the Settings page, select the Stripe tab on the left side.

Configuring Stripe Settings in Docebo

Flag the Enable option a the top in order to allow your users to pay via Stripe. Choose the Payment Type by flagging whether you want to use Simple Charge or Stripe Order. Please refer to the corresponding section in this article to learn more about these options.

stripe tab

For those using Docebo 6.9 or higher, you can flag the option to enable AliPay  in your LMS, but please note it only works if you have configured AliPay and Stripe together outside of Docebo. Insert your Stripe account email, live secret key, and live publishable key into the corresponding text boxes. All of this information is available in your Stripe Admin Dashboard. If you need help finding this information, refer to Stripe’s support area.

stripe secret keys

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 the secret key and publishable key fields that appear below the option, when flagged.

Stripe Payment Type Options

When choosing the payment type on the integration page you can select between a simple charge or stripe order.

  • 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 Aashboard. This option requires no further configuration in your LMS or in Stripe.
  • Stripe Order. Taxes can be applied during the transaction process. This option also provides 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). Below, read how to configure each option.

Stripe Order Payment Type: Tax Included

If you want all of your payment transactions from your Docebo LMS to have a fixed tax included in the payment, you can set this option in Stripe. Access your Admin Dashboard in Stripe, then press your username in the top right corner and select Account Settings from the dropdown menu. In the pop up box, move to the Orders section. Press the Change Tax button in the Taxes area. In the Type dropdown menu, select Included, then press Update. Then, press Done in the pop up box.

stripe included tax

Now, when a user completes a payment, you will see the 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 Order Payment Type: Fixed Tax Percentage

If you want all of your payment transactions from your Docebo LMS to have a fixed tax percentage, you can set the percentage in Stripe. Access your Admin Dashboard in Stripe, then press your username in the top right corner and select Account Settings from the dropdown menu. In the pop up box, move to the Orders section. 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. Then, press Done in the pop up box.

stripe percentage tax

Now, when a user completes a payment, you will see the 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 Order Payment Type: Third Party Tax Provider

If you want all of your LMS 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. Press your username in the top right corner and select Account Settings from the dropdown menu. In the pop up box, move to the Orders section. Press the Change Tax button in the Taxes area. In the Type dropdown menu, select Provider. Select which provider from the dropdown menu that will appear below, then press Update. Then, press Done in the pop up box.

stripe provider tax

Now, when a user completes a payment, you will see the 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 LMS. Refer to this link to learn how to retrieve your tax code.

Important Notes for Docebo’s Stripe Payment Gateway

Please pay attention to the following notes when using this payment gateway in your Docebo LMS:

  • Every time a user buys a course in your Docebo LMS using Stripe as the payment gateway, 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 LMS, 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 LMS, 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 LMS interface during the checkout process in Docebo. Rather, just the price of the object will appear in the LMS 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 settings up this payment gateway in your Docebo LMS is identical when using either a single domain or Docebo’s Multidomain functionality.
  • This integration does support the Callback tax option for those that select the Stripe Order payment type.