What is Shopify and why would I use it?

Shopify is a powerful ecommerce website solution that allows you to sell online.  To allow for more advanced ecommerce solutions than ever before, Litmos has developed an app to allow you to sell your Litmos courses using Shopify.  Some of the advantages to using Shopify are:

• Custom storefront
• Marketing and SEO features
• Coupon Codes
• Bundling courses
• A large selection of payment choices

 

UPDATE: November 2019

Please note the changes to our application with the release of the new private app method of integration. We will no longer support the legacy integration that utilized the https://api.litmos.com/v2/shopify web-page as this method was found to be unreliable. This new method will require that you manually create items in Shopify with their appropriate course code SKUs but ensures a much more reliable integration. 

You will need to delete the old app first to move forward with the new version. 

 

Create a Private App on Shopify

To create a private app on Shopify, login as an Admin and navigate to Apps --> Manage private apps, and then click "Create a new private app":

 

 

Once an app name and developer email have been entered, proceed to ensure the API credentials provide appropriate access to all Admin API Permissions. All of the following need "Read and write" access:

 

 

Next, ensure your store will "Allow this app to access your storefront data using the Storefront API" and all of the following settings are enabled:

 

 

Next, proceed to "save" the app. Once saved, the API key and password will display.

 

 

Update the Webhook API version to the latest available stable version

 

These details will be entered into Litmos to complete the Shopify integration configuration. To begin, click "Add a new Store" and enter the details needed from the private app. If you have multiple stores to connect to the Litmos org, repeat the process as needed to connect up to 10 Shopify stores in total.

The Shopify Site Name (URL) is only the custom part of the URL. For example, if your URL is http://litmos.myshopify.com/ , you will only enter litmos into the field.

 

 

Each store that is connected can also have a Brand associated to the store. This ensures that any customer who purchases a course or learning path from the store and has a new Learner profile created in Litmos will be added to that Brand in the Litmos organization. The Brand feature controls the UI theme and customizations for various groups of Learners, so the Brand UI can be tailored to match the Shopify store UI for a seamless user experience!

 

Note: The Order in Shopify will need to be "fulfilled" for Litmos to process it. Orders must be fulfilled from bottom to top. You can do this manually in the Orders section, or configure your store to "Auto-fulfill" in Settings > Checkout > Order processing : https://help.shopify.com/en/manual/checkout-settings/order-processing#automatically-fulfill-orders

 

Set Up in Litmos

In Litmos navigate to the course and scroll towards the bottom to enabled "I want to sell this course". This is needed to add the course as a product on the Shopify store. 

 

 

Next, navigate to the Shopify products list --> add a new product --> make sure the product's SKU matches the "course code for importing people in bulk" for the same course that was just enabled for sale. This is necessary to ensure Litmos knows what course is being purchased in Shopify. If these codes do not match, the learners purchasing the course(s) will not be assigned to a course in Litmos.  

 

 

The steps are detailed below:

Shopify

1. Navigate to the Admin View
2. Select "Products"
3. Select the course to view
4. Navigate to the "Pricing" section and view the field for "SKU"

Litmos

1. Navigate to the Admin View
2. Select the "Course" tab
3. Select the course from the list
4. Click on the "Settings" sub tab 
5. The Course Code will be listed in bold in a yellow box on the right

IMPORTANT NOTE: If it is a Learning Path, in the settings if you see 1234-LP, the SKU should be LP_1234

    B) Is the order fulfilled? You can check if the order is fulfilled by going to Orders and checking the "Fulfillment" column for the order. 

 

Common Issues:

1) A user purchased a course or learning path and did not receive an email to login.

Please note that Shopify allows customers to complete the checkout by entering an email or a phone-number.

Since the Litmos integration with Shopify relies on the email address entered by the customer during checkout, if a customer completes the checkout by entering a phone-number instead of an email address, no email will go to the customer. A phone number will exist on the email field for that individual in Litmos and the phone number will also exist on the username field for that individual. Please instruct your customers to checkout using email addresses to ensure they receive Litmos emails.

If you go to Settings > Checkout > Customer Contact you can require an Email at check out. 

 

Please ensure that the orders in Shopify are not archived. Litmos won't be able to retrieve the order details of an archived order from Shopify. 

 

User Experience

Below are the steps that a user will go through when purchasing a course through Shopify.

1. They will navigate to your Shopify storefront.
2. They will find and purchase the course through Shopify.
3. They will receive an email from Litmos that contains a login key.  The purpose of this email is to verify this user.
4. Litmos will pull the First Name, Last Name, Email Address (becomes username)
5. They will set up a password and enter any additional user profile information.
6. They can now take your course in Litmos.