How to Integrate TapMango and Shopify

This guide walks you through integrating TapMango and Shopify so customers can start earning points for their purchases.

Setting Up Your Shopify Integration

---

Step 1. Send us your Domain

To find your Shopify domain, log into your Shopify account then click Settings in the bottom left corner.

	The domain will be listed on the Settings page and ends with .myshopify.com. TapMango needs the complete domain to add the integration to your account.

Important: If you have a custom domain with Shopify for e-commerce, TapMango requires the original domain for your store.

Step 2. Install TapMango Connect

Next, add TapMango Connect to your Shopify account. 

TapMango Connect is publicly listed on the Shopify app store. Click here to open the app store page and click Add App to add TapMango Connect to your Shopify account.

On the next page, authorize permissions for TapMango to access and store customer information.

By clicking Install App, you are agreeing to all permissions.

Step 3. Accept the Charges & Notify TapMango

Open TapMango Connect to accept the charges:

• From the Shopify Admin page click Settings in the bottom left > from the menu click Apps and sales channels > click the 3 dots beside TapMango Connect > click Open. 

Step 4. Notify Tapmango 

Notify TapMango support or your account manager that you have installed the TapMango Connect app so that the integration can be enabled.

Note: After accepting the app charges, you may see the following message: "Your integration has been disconnected. Please reach out to [e-mail] or contact your CSM to reactivate your integration or finalize your account closure."

This is normal - it is only notifying you that the integration has not yet been enabled on TapMango's end.

TapMango Connect Overview

---

Existing merchants with TapMango can click Continue at the bottom right corner for more options such as a quick link to the merchant portal, instructions for installing the TapMango Widget on your Shopify online store, instructions for creating the TapMango Connect tile on in-store POS, disconnecting the integration, and a link to our Terms and Conditions.

How Does The Shopify Integration Work?

---

See our guide for the in-store workflow:

Shopify Integration - Workflow (retail)

Note: Currently, we do not support redeeming rewards in-store via Shopify. Redemptions must be done directly in TapMango via the Tablet, Web Portal, or Desktop Application.

What About eCommerce?

---

We can do that too. This requires some additional setup, like deciding on and setting up rewards that are right for your online store.

Shopify Integration - eCommerce

Shopify Integration - Setting Up Rewards (eCommerce)

Troubleshooting

---

"Refused to Connect" Error

If you see a "Refused to connect" error when opening the TapMango Connect app (shown below), it's likely due to one of two things:

1. the user signed in to Shopify does not have permission to access the app
2. the $10/month app charge has not yet been accepted.

1. Staff Member Does Not Have Permission

If a staff member is signed in to Shopify (rather than the store owner), they need permission to manage and install apps. You can use the following steps to grant access:

① From your Shopify admin, click the Settings gear icon in the bottom left corner.

② Click Users and permissions.

③ Select the staff member's name.

④ Scroll down to the Apps and sales channels section.

⑤ Toggle Manage and install apps on, or check the boxes for the specific apps you want them to access.

2. App Charge Has Not Been Accepted

If the only user is the store owner (who has full permissions by default), the issue is likely that the TapMango Connect app charge hasn't been approved yet.

① From your Shopify admin, navigate to Settings > Apps and sales channels.

② Find TapMango Connect in the list.

③ Instead of clicking Open App, look for a link that says View details or App settings.

④ If you see a banner at the top that says Update App or Review Permissions, click through and approve the charges.

Once the charge is approved, reopen TapMango Connect and the error should be resolved.

Additional Questions?

As always, if you have any additional questions that aren't covered in this guide do not hesitate to contact us and we'll be happy to help.