Alpine IQ integration guide for Dutchie POS
This article applies to Dutchie POS.
Integrate Alpine IQ with Dutchie POS.
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
- 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
Alpine IQ Side
To enable the Alpine IQ integration on your Dutchie Ecommerce account, please first contact Alpine IQ to obtain your Authorization Token. Next, provide that information to your Dutchie Ecommerce Customer Success Manager and they'll enable the integration for you.
Alternatively, you can locate your Authorization Token by following these steps from within your Alpine IQ account:
1. Click on "Settings" (top left), then the header section labeled "API."
2. Copy the entire key within the "Your key" box
Dutchie POS Side
Once you obtain this API Key follow these steps to complete the setup:
- Go to Setting > Integrations > Alpine IQ
- Paste in the API Token you copied from Alpine IQ.
- 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.
- 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 Ecommerce, log in to Dutchie Ecommerce 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 Ecommerce. This allows dispensary staff to apply the reward at the POS without deducting points twice.
Set up Alpine IQ discounts in the Backoffice
- Ensure the Alpine IQ integration is enabled.
- Create the discount in your Alpine IQ account.
- Copy the discount ID found from the Discounts page in Alpine IQ.
- In the Dutchie POS backoffice, go to Marketing > Discounts.
- Click Create discount.
- Fill out the required fields and make sure the discount name matches between Dutchie POS and Alpine IQ
- In the Application method field select By Alpine IQ from the dropdown.
- Enter the discount ID copied from Alpine IQ into the Alpine IQ discount ID field.
- Click Create.
Sign customers up for Alpine IQ
Budtenders can sign customers up for Alpine IQ loyalty directly from the Dutchie Register:
- With a guest profile assigned, click the Register for Loyalty button.
- Confirm all the fields in the Loyalty Registration window are correct and click the Sign up button.
If you don't see the Register for Loyalty option, contact Dutchie support and ask to have the Register Loyalty Popup and Signup customer features enabled.
Redeem Alpine IQ rewards
If you want discounts configured in Dutchie POS to apply before Alpine IQ loyalty discounts, go to Settings > Location in the Dutchie Backoffice and enable the Apply Alpine IQ and Springbig Discounts Last setting.
If the customer 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 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).
- 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 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 customers enrolled with Alpine IQ.
Related articles