About the AIQ <> Flourish Integration
Review our Integration Grid for supported features.
This article covers Flourish connection for AIQ Marketing + Loyalty only. If you are looking for AIQ Ecommerce instructions, see Connect Floursh to AIQ Ecommerce.
How to connect AIQ and Flourish
In AIQ, navigate to Settings > API & Tracking to obtain your API key and UID
In Flourish, follow their guide to enable AIQ in your point of sale
Once completed, obtain your Flourish credentials.
On the Flourish Integration Settings for Alpine IQ, select Generate to create a username and password
In AIQ, navigate to Settings > Integrations, search for Flourish and click on it to open the integration card.
Fill out the credentials
Username (Required)
Key (Required)
Regions (Optional)
After these are filled in, click the Add Credential button.
Scroll down to the Loyalty section and check off the box next to Required: All users from this source have passed an age gate compliant with my industry.
Lastly, click the purple Connect button in the top right. You have now completed the minimum settings needed to connect your integration!
🚨 Important: WARNING: Do not touch any other settings in this card without consulting an Onboarding Specialist or Customer Success Manager - This could automatically begin sending out SMS opt in requests or auto-enrolling loyalty shoppers.
How to Map a Store
Navigate to Settings -> Company Account > Retail Store
Click Edit on the store you wish you map
Under Store Mappings you'll see the Flourish 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 Flourish: Merchant Guide
Flourish Integration Preferences
It is recommended to review the settings on the Flourish side that would affect things like:
Requiring Phone numbers and/or Emails
Defaulting which POS tab displays per member type
Custom URL for your signup form on receipts
Please refer to their guide here: Flourish Integration Preferences
Signing up new loyalty members during checkout
Flourish allows onboarding new shoppers and existing shoppers into marketing communications. Please refer to their in-depth guide on how to make sure shoppers are taken care of during your in-store process here: Flourish Profile Documentation
Setting Up Discounts
Flourish has the ability for in-checkout redemption. In order to utilize this function you must make sure the discounts exist in both systems!
Please note that Flourish is responsible for the actual checkout behavior whereas AIQ determines who can get the discount and how many points it requires.
Create your discount in Flourish first. Use this guide for assistance in setting this up
After you create the discount in Flourish and have the discount ID, you can now create the discount in AIQ
In AIQ, create either a flat ($) or percent (%) based discount
After adding the discount value, select Trigger a partner platform reward
Select Use with existing
Select POS Discount ID
Enter the Discount ID you obtained from Flourish
Additional AIQ Settings
The following additional settings are available on the Flourish integration card in AIQ. To access them, navigate to Settings > Integrations, locate Flourish 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 Flourish 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 Flourish and AIQ.
From POS to AIQ: Updates made to shopper profiles in Flourish (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 Flourish, a new shopper profile will be created in Flourish automatically.
⚠️ Warning: The POS remains the source of truth — to change a shopper's contact info, update it directly in Flourish 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
Enabling this will make AIQ only sync contacts that belong to the given credential's region/state.
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
How long does it take before I start to see my POS data in AIQ?
Within 24 hours, you should see data populating in AIQ. Although with Flourish we typically see data flow within four hours.
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 "Flourish" 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.
Need Help?
If you need assistance, reach out to AIQ Support anytime via chat widget within your AIQ Dashboard.