About the AIQ <> Dutchie POS Integration
Review our Integration Grid for supported features.
This article covers Dutchie POS connection for AIQ Marketing + Loyalty only. If you are looking for AIQ Ecommerce instructions, see Connect Dutchie POS to AIQ Ecommerce.
How to connect AIQ to Dutchie POS
AIQ Setup
Reach out to [email protected] and request:
AIQ to be enabled as an integration
Your Dutchie POS API keys
Ensure permissions for customers, transactions, products, and inventory is enabled on the API key.
Multiple Locations: If you have multiple locations, you will have one API key for each location. In some markets, you will also have a different API key for medical or recreational menus.
Navigate to Settings > Integrations, search for Dutchie POS and click on it to open the integration card.
Add your Store Name (as provided by DutchiePOS) and your API key in the Key fields and click the Add Credential button.
Scroll down to the Loyalty section bottom and check off \All users are age compliant with my industry?*
Click the purple Connect button in the top right and your DutchiePOS integration will start pulling data!
🚨 Important: NOTE: Do not touch any other settings in this integration card without consulting an Onboarding Specialist or Customer Success Manager as they can affect your data and the shopper's opt-in status.
Dutchie POS Setup
In AIQ, navigate to Settings > API & Tracking to obtain your UID and API Key.
Provide these to your Dutchie POS representative in order for them to activate discount syncing.
Once enabled you can optionally configure 2FA settings by going to your DutchiePOS Settings > Integrations > Alpine IQ
Disabling 2FA will bypass the need to send a code to the shoppers phone. This can be overriden a Master PIN code in Loyalty Settings
How to Map a Store
Proper store mapping ensures that data flows correctly and that reporting assigns signups or sales summaries to the correct retail location. Follow these steps to map your retail store:
Navigate to Settings -> Company Account > Retail Store
Click Edit on the store you wish you map
Under Store Mappings you'll see the DutchiePOS symbol
Click on the empty field to the right of the symbol and a dropdown will appear to "map" the key
Click Save settings and you are done mapping the store. Keep in mind this must be repeated for any additional stores that you add to the account.
AIQ x DutchiePOS: User Guide
In AIQ, navigate to Settings > API & Tracking to obtain your UID and API Key. This will need to be provided to your Dutchie POS representative in order for them to activate discount syncing.
How to setup AIQ integrated discounts in Dutchie
Create a discount inside AIQ
Set Redemption Settings: In the 'Redemption Settings' of your discount deals, Leave Redemption setting in AIQ unchecked(functions in place of N/A similar to Legacy setting) The 'Trigger a partner platform reward' option is not required for the Dutchie integration and can cause issues if enabled
Fill out all other required fields and save
Copy the discount ID found on your Discounts page (left column)
Replicate Discounts in Dutchie, navigate to Marketing -> Discounts
In the "Application Method" select "By Alpine IQ"
Add the AIQ Discount ID to the "Alpine IQ discount ID" field in DutchiePOS. This step ensures that the shopper-facing cart in Dutchie correctly applies the discount, while AIQ handles loyalty point deductions when the discount is redeemed.
Avoid End Date Issues: If you need discounts to be continually available, ensure no end date is set in the discount configuration.
Repeat for additional discounts
Verifying Discount Setup
After configuring discounts, verify the setup to ensure accuracy. Perform these steps:
Check Discount Display: Verify that the discount appears correctly in the Dutchie system and is linked with the AIQ ID.
Test Discount Application: Add the discount during checkout using a loyalty profile in AIQ to confirm the following: - The discount is applied to the cart correctly in Dutchie. - AIQ deducts the appropriate number of loyalty points upon application. Purchases can be completed and canceled afterward to test functionality without completing a real transaction.
Sync Verification: Discounts created in AIQ should sync immediately, ensuring instant reflection on your website and integration platform. If syncing does not occur, double-check the configuration settings.
Signing up new loyalty members during checkout
Dutchie is no longer actively supporting the in-POS "Register for Loyalty" button. The recommended method for enrolling new shoppers at checkout is through the AIQ Signup Form.
✅ Recommended Flow: Open your AIQ Signup Form in a browser, fill it out for the shopper, then in Dutchie Register click the + next to Guest, search by phone or email, and click Attach to Cart. Finish checkout as normal. Their loyalty Persona will show up in AIQ right away, and the purchase syncs on the standard import schedule.
Redeeming Discounts
If the shopper placed their order through Dutchie Ecommerce and selected their own reward on the checkout screen, it will appear on the right sidebar. Click Redeem to apply it to the order.
Otherwise, you can browse and apply an available reward manually:
Click the ... button and select Redeem AIQ.
Enter the shopper’s phone number and click Get Code.The shopper will receive a code via text. Enter the code and click Open Wallet. (These steps do not apply if you set Bypass 2FA to Yes).
Select an available reward to apply to the transaction.
Get points balance
To see a shopper’s points balance, click the ... button and then Redeem AIQ. A pop-up window will appear that shows the available points, the points redeemed, and the points remaining.
Add loyalty indicator to customer cards
To help budtenders quickly identify shoppers enrolled in Alpine IQ loyalty, update your customer cards to include a loyalty indicator icon:
Go to Settings > Registers.
Select Configure.
Select the Cards tab.
Check the box for Loyal vs. Non-loyal.
Click Save.
A yellow star icon will now appear on the guest list card and cart view for shoppers enrolled with Alpine IQ.
Creating Audiences in AIQ from Dutchie POS's Discount Groups
First, create your
Discount Groupin Dutchie POSThen in AIQ, navigate to Customers > Audiences > Create New
Build the following audience:
Custom brand traits:Discount Groups:contains:{{Discount Group name}}Save
Note: Once the audience is created in AIQ, any persona/contact that gets added to the Discount Group in Dutchie POS will automatically be added to the audience in AIQ.
Mirror Archives
Mirror Archives is a Dutchie POS–specific feature that ensures order counts remain consistent between your POS and AIQ, even when profiles have been archived or merged on the POS side.
When to Use It
Enable this setting if your POS has many archived profiles with historic sales attached, or if your team frequently archives or merges shopper profiles in Dutchie POS.
Mirror Archives helps maintain a consistent relationship between orders in Dutchie POS and personas in AIQ, ensuring historic orders are not lost when profiles are archived.
How It Works
By default, AIQ integrations pull order and shopper data for a limited historical period (typically about one year prior to integration setup, unless otherwise configured).
When Mirror Archives is enabled, AIQ extends the data lookback period to include the full available history in Dutchie POS, instead of only recent data.
When profiles are archived or merged in Dutchie POS:
AIQ creates mirrored archived profiles so historic orders remain connected • Orders attached to archived or merged profiles continue to exist in AIQ • Order counts stay aligned between Dutchie POS and AIQ
Because older historical data is now included, personas who have not purchased in over a year may appear in AIQ for the first time.
Mirror Archives is retroactive, so historic sales attached to archived profiles are also reflected once enabled.
Can Mirror Archives Create Duplicates?
Mirror Archives itself does not intentionally create duplicate personas. However, enabling it can introduce additional personas from older historical data.
In some cases, shoppers may have older accounts with different personal information, such as:
Old email addresses
Old or changed phone numbers
Slight name differences
Missing or incomplete contact information
If this older data does not match existing personas in AIQ, the system cannot automatically merge them, and they will appear as separate personas. If matching PII (such as phone or email) is present, normal persona merging rules apply and duplicates will merge automatically.
As a result, clients may see an increase in persona counts after enabling Mirror Archives. These are typically older shoppers being pulled into AIQ rather than newly created duplicates.
Points Adjustments
If a persona redeemed inflated points before being removed or archived, they may temporarily appear with a negative points balance after Mirror Archives syncs historic activity. In most cases, the system automatically reconciles the balance so shoppers can continue earning points normally going forward.
Additional AIQ Settings
The following additional settings are available on the Dutchie POS integration card in AIQ. To access them, navigate to Settings > Integrations, locate Dutchie POS and click on it to open the integration card.
Use AIQ's last backup
Freezes data from this source at the last audience run and stops AIQ from hitting the Dutchie POS API for new data.
⚠️ Warning: Do not turn this on unless you are switching POS systems and want to retain existing data.
Sync Personas / Sync Contacts
Enabling this setting allows AIQ to keep shopper records aligned between Dutchie POS and AIQ.
From POS to AIQ: Updates made to shopper profiles in Dutchie POS (e.g., name, email, phone number, or date of birth) will flow into AIQ.
From AIQ to POS: If a shopper signs up through an AIQ form and no existing match is found in Dutchie POS, a new shopper profile will be created in Dutchie POS automatically.
⚠️ Warning: The POS remains the source of truth — to change a shopper's contact info, update it directly in Dutchie POS so it flows through to AIQ. Syncing begins from the day it is enabled; existing records will not be retroactively synced.
Sync to relevant market / Sync to state
When enabled, AIQ will only sync contacts that belong to the region or state associated with the given credential.
Mirror Archives
A Dutchie POS-specific feature that ensures order counts remain consistent between your POS and AIQ, even when profiles have been archived or merged on the POS side. See the Mirror Archives section above for full details.
Send SMS double opt-ins to Personas who purchased after
Sends an SMS double opt-in request to shoppers with a phone number who had a sale on or after the date you specify. Takes 24 hours to trigger.
⚠️ Warning: If this setting is removed after it has been set, it can cause loyalty Personas to be lost if they only became a member through this setting and did not use a signup form. We do not recommend changing this after it is set.
Enroll Personas in loyalty program who purchased after
Automatically enrolls shoppers in the loyalty program if they had a sale on or after the date you specify. Enrolled shoppers earn points for sales on or after that date. Takes 24 hours to reflect.
FAQs
Why is my shopper not tagged as a loyalty member in Dutchie POS?
A loyalty tag will appear on the shoppers profile in Dutchie if the shopper was signed up in DutchiePOS
What fields do we sync with?
Name, phone, email, gender, birthdate, address, medical ID, discount groups, sales.
Since you sync these fields, how can I lookup a shopper in Dutchie POS?
You can only lookup AIQ members in Dutchie POS via phone number.
How long does it take before I start to see my POS data in AIQ?
Newly added POS integrations in AIQ often take 24 hours to sync for the first time. This delay allows the system to process sales via the API keys and make the store information available for mapping.
If no sales have occurred yet, the system will defer updates until the day following the first sales transaction.
How can I confirm that the integration is active and signups are being sent?
Look under your Personas page in AIQ. The integration is functioning properly if you see "leaflogix" under the Sourced from column
I am getting an account notification that I have unmapped stores, how can I fix this?
Once you see data coming through AIQ, you must "map" the API key to the store(s) to assign a "favorite store" to the shopper. See How to Map a Store above for directions on how to accomplish this.
Help, I read this entire document and still need assistance!
You can read Dutchie's help doc for enabling AIQ
Can I create Audiences in AIQ from Dutchie POS's Discount Groups?
Yes, see steps above: Creating Audiences in AIQ from Dutchie POS's Discount Groups
Why are discounts applying to multiple items?
If this is not desired, you can update the discount settings within Dutchie POS. Navigate to Discount > Options > Rewards > Options > Discount Method
If a transaction is completed and then a budtender needs to do a refund, do loyalty points used on the purchase get automatically refunded?
This functionality is controlled by DutchiePOS. At this time, they do not support this and refunds must be completed in AIQ.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.