Skip to main content
Here’s how you set up the Shopify POS integration with Customer Engagement. This article has two main sections:
  1. Getting your Shopify app to work for the POS integration
  2. Setting up the Shopify mobile POS app (if you are using it)

​
POS configuration of Shopify app

This involves some extra configuration added to an already functioning implementation of the Voyado Customer Engagement app for Shopify. Complete the e-com configuration and then return here for the extra configuration needed for the POS integration.

See the basic Shopify Customer Engagement e-com integration

Then (or if your e-com configuration is already done) go through the steps below. There are the additional configuration steps you’ll need to get the POS integration working with your “Voyado Customer Engagement” app in Shopify. There are three things you’ll need to adjust in the app settings:
  1. Store to Country Mapping
  2. Promotions & reward voucher sync
  3. Data import

​
1 - Store to Country Mapping

In this step, you’ll connect your stores in Customer Engagement to the location in Shopify, using the second option on the panel, Shopify POS location. The values for the first option, Shipping country, will already exist if you have already done the e-com configuration. If, however, you’re doing the e-com and POS configurations at the same time, you can take these two tasks in any order. If you’ve not yet filled in anything in this panel, it’ll look like this:
Store to Country Mapping not filled in
If you have already filled in the shipping country values, the panel will look like this:
Store to Country Mapping already filled in
In both cases, select “Add mapping” to get started. Now select the second option, “Shopify POS location”:
Store locale mapping

Store locale mapping

You will see two drop-downs. The first has all your Voyado Customer Engagement stores, the second your Shopify locations. Only Customer Engagement stores of type “RETAIL” will appear in the “Voyado store” list. Select the Shopify location for each of your Customer Engagement stores. Then select “Save”.

​
2 - Promotions & reward voucher sync

To use promotions and vouchers from Customer Engagement in the Shopify POS app, you’ll need to activate that here. Promotions and vouchers from Customer Engagement are handled as different kinds of discounts in Shopify.
Promotions & reward voucher sync
“Enable promotion sync” allows you to use Customer Engagement promotions in the Shopify POS app. “Enable loyalty voucher sync” allows vouchers to be created in Customer Engagement and used in the Shopify POS.
To use promotions and vouchers in the basic e-com integration, you’ll need to have enabled the app embed block. This, however, does not apply for the POS integration, where selecting the check-boxes in the panel is enough.
For details on using promotions and vouchers in the POS integration, see here:

Promotions and vouchers in POS integration

​
3 - Data import

This allows you to migrate customers and orders from your Shopify account to Customer Engagement through the Voyado Customer Engagement app, enabling you to start your Customer Engagement journey with your data already in place. If you have the Shopify POS integration with Customer Engagement, this step will migrate that data as well.
Store locale mapping

Store locale mapping

There are two cases to consider here:
Import customer data

Import customer data

Here, you’ll select the “Import customer data” options and then hit “Submit”. This will migrate all your Shopify customers (and POS customers, if applicable) to Customer Engagement. If they don’t already exist in Customer Engagement, they will be created there as contacts.If a migrated customer already exists in Customer Engagement, the app will not update their data, but just fetch the contactId reference from Customer Engagement and store that in Shopify.This app can also handle customers that were created only in Customer Engagement or imported there through other channel, such as a CSV file import, or via some other platform. This is important in the next step when migrating orders.“Import customer data” will fetch and store the contact ID of any customer who was created in Customer Engagement outside of the app.
This starts a migration of Shopify orders, both purchases and returns, to Customer Engagement (and POS orders, if applicable). For this to work, the customer who made the order must already exist as a contact in Customer Engagement. That’s why you’ll always select the “import customer data” option here. Doing this ensures that customer data is synced before orders data is migrated (as there always needs to be a customer to connect an order to).If, for example, a customer exists in Customer Engagement but not in Shopify, the app, when matching orders to customers, will fetch the contactId reference from Customer Engagement and store it in Shopify. This is relevant for any customer data imported into Customer Engagement outside of the app.
Import order data

Import order data

The order data option allows you to specify “Start date” and “End date”. Then you will only sync those orders created inside that time window. Hit “Submit” to start the migration.When doing an order data migration, the app will process the data in this order: customer import first, and then the order import.The migration of customers and orders can activate automations for those customers that exist in Customer Engagement. If you have automations set up to trigger on “New contact registered”, “Product purchase” or “New return”, you should deactivate these during this migration.

​
Shopify POS mobile app

This is the procedure for installing and using the Voyado Customer Engagement POS app for Shopify on your mobile device.
1

Download the app

The Shopify POS app can be downloaded from the Google Play Store or the App Store depending on what mobile device you want to use as your Shopify POS.

Google Play Store

Apple App Store

2

Log into the app

Open the app on your device and log in with your Shopify account credentials. You’ll need to enter a PIN code to allow fast unlocking of the app. Then go to the “Home” screen, which will look like this (here, the app is in Dark mode, in basic mode the background is white).POS app home screen
3

Connect to Customer Engagement

You’ll now need to install the connection to Customer Engagement. Select “Add tile” and then “App”. Here, search for the Voyado Customer Engagement POS app and install it. Once that’s done, the “Manage Voyado discounts” tile will appear.Manage Voyado discounts
The installation is now complete.