Dutchie POS integrates with Alpine IQ to help cannabis operations create and update records in the POS and manage loyalty point accrual and discount tracking. In this guide, you will learn: 

• Integration requirements
• Alpine IQ field mapping
• Obtain an API key for Alpine IQ and enable integration
• Set up Alpine IQ discounts in the Backoffice
• Sign customers up for Alpine IQ
• Authenticate loyalty members
• Redeem Alpine IQ rewards
• Get points balance
• Add loyalty indicator to customer cards

Integration requirements

• This integration requires certain features to be enabled in the Backoffice. Contact your Dutchie administrator to ensure you have the appropriate features enabled and to obtain an API key for Alpine IQ.
• Your store name in Alpine IQ must be the same as your location name in Dutchie POS. 

Alpine IQ field mapping

The following fields map from Alpine IQ to the Customer Profile in Dutchie Register:

• Name
• Phone
• Email
• Gender
• Birthdate
• Address
• Med ID
• Discount groups
• Sales

If you update any of this information in Dutchie POS after signing a customer up for Alpine IQ, the changes are automatically sent to Alpine IQ as well.

Obtain an API key for Alpine IQ and enable integration 

Dutchie POS Side

Once you obtain this API Key follow these steps to complete the setup:

1. Go to Setting > Integrations > Alpine IQ
2. Paste in the API Token you copied from Alpine IQ.
3. By default, before redeeming Alpine IQ rewards the budtender must enter the customer's phone number and select Get code, which sends the customer a text message with a code that the budtender must enter to authenticate the customer's loyalty account. If you want to skip this step, set Bypass 2FA to Yes.
4. Click Save.

Remember to also provide to Alpine IQ the API key that was generated from Dutchie POS by your Dutchie admin.

If you're also integrated with Dutchie E-Commerce, log in to Dutchie E-Commerce Admin and go to Settings > Integrations > Dutchie POS > Settings tab. Check the box for Redeem Reward at POS. 

This makes it so customers' loyalty points aren't deducted from their wallet until the order is completed in Dutchie POS instead of when the customer submits their order in Dutchie E-Commerce. This allows dispensary staff to apply the reward at the POS without deducting points twice.

Set up Alpine IQ discounts in the Backoffice

1. Ensure the Alpine IQ integration is enabled.
2. Create the discount in your Alpine IQ account.
3. Copy the discount ID found from the Discounts page in Alpine IQ.
4. In the Dutchie POS backoffice, go to Marketing > Discounts.
5. Click Create discount.
6. Fill out the required fields and make sure the discount name matches between Dutchie POS and Alpine IQ
7. In the Application method field select By Alpine IQ from the dropdown.
8. Enter the discount ID copied from Alpine IQ into the Alpine IQ discount ID field.
9. Click Create.   

Sign customers up for Alpine IQ

Budtenders can sign customers up for Alpine IQ loyalty directly from the Dutchie Register:

1. With a guest profile assigned, click the Register for Loyalty button.
   
2. Confirm all the fields in the Loyalty Registration window are correct and click the Sign up button. 

Redeem Alpine IQ rewards

If the customer placed their order through Dutchie E-Commerce 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:

1. Click the ... button and select Redeem AIQ.
   
2. Enter the customer’s phone number and click Get Code.The customer 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).
3. Select an available reward to apply to the transaction.
   

Get points balance

To see a customer’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 customers who are loyalty program members, update your customer cards to include a loyalty indicator icon:

1. Go to Settings > Registers.
2. Select Configure.
3. Select the Cards tab.
4. Check the box for Loyal vs. Non-loyal.
   
5. Click Save.
6. A star icon will now appear on loyalty members' guest list cards and carts.

Alpine two-factor authentication (2FA) troubleshooting

If you are using Dutchie POS and Dutchie E-Commerce together, and you utilize two-factor authentication (2FA) for Alpine, you may find the requirement remains active on Dutchie E-Commerce despite being disabled in Dutchie POS or in Dutchie POS when disable on Dutchie E-Commerce.

2FA settings must be configured separately in Dutchie E-Commerce and Dutchie POS.

Issues checking out while customer is logged in

If your customer experiences a checkout error while logged in after your dispensary switches from Alpine IQ to Dutchie Loyalty and Marketing, verify integration configuration and ensure loyalty integration settings are properly configured for embedded menus.

Troubleshooting AIQ vs Dispense API key

AIQ (Alpine IQ) has acquired Dispense, and the phrases "AIQ API key" and "Dispense API key" are sometimes used interchangeably, leading to confusion.

• The AIQ API key is for loyalty only.

• The Dispense API key is used for AIQ E-commerce. You can find this key in Dutchie POS Backoffice.

Related articles

• Redeem Alpine IQ rewards at the register
• Alpine IQ | Dutchie E-Commerce - How to set up integration