🟢Shopify POS

Which Shopify integration do I need?

Boomerangme offers two separate ways to connect to Shopify:

	Shopify POS	Shopify
How it connects	Custom app created in your Shopify store (Admin API)	Ready-made app installed in one click from Integrations
Card types	Stamp, cashback, discount, or reward	Cashback only
Boomerangme branding	None — no storefront widget, no Boomerangme branding visible to customers	Storefront widget with Boomerangme branding, visible to customers on the store
Can be connected via a white-label domain	Yes	No
Accrual depth	For stamp and reward cards, accrual must be done manually through the in-store Scanner app	Fully automatic — no scanner needed, points/cashback accrue directly from Shopify orders

Correct way to connect Shopify

Correct: Connect the Shopify store only inside the client's sub-account — the one that must receive orders, points, and customer data.

Incorrect: Connecting Shopify in your agency account first and then trying to reconnect it in the client's sub-account. Even with the same Shopify login, the app becomes bound to the first location it was connected in. This applies to both this integration and the native Shopify app.

If you already connected it incorrectly, here's how to fix it:

1. Completely remove the Boomerang app from the Shopify store.

2. Make sure the integration is disconnected in your agency account.

3. Log into the client's sub-account using app.boomerangme.cards or your agency's white-label domain, if you have one configured.

4. Reconnect Shopify only from inside the client's sub-account.

5. Re-enter the custom app's Access Token to confirm the connection.

Step 1. Create a custom app in your Shopify store

1. Log in to your Shopify store.

2. Go to Settings → Apps → Develop apps → Build apps in Dev Dashboard.

1. In the Dev Dashboard, click Create app and give it a name.

2. Create a version for your app:

   • In the URLs section, define your app URL. If your app isn't embedded in the Shopify admin, you can use the default URL https://shopify.dev/apps/default-app-home.

• In the Webhooks API Version, select the latest available version.

• In the Access section, enter the following Admin API access scopes:

read_products, read_orders, read_customers, read_returns

1. Click Release, then confirm by clicking Release again.

1. Back in the Dev Dashboard, open the Apps section, select the app you just created, go to the Installs section, and click Install app. If you have multiple stores, select the store you want to install it on.

2. Confirm the installation by clicking Install.

When you click Install, Shopify shows a confirmation screen listing the data the app needs access to, along with an orange "This app hasn't been reviewed" warning. This is expected for custom apps — they aren't submitted for Shopify's App Store review process. Review the requested permissions and click Install to confirm.

Want to test this first without touching your live store? You can create a free Shopify Dev Store through the Partner Dashboard and repeat these steps there before doing the same in your real store. This is optional — the steps themselves are identical either way.

For a store, it is better to choose Grow plan (on Basic you will need to create webhooks manually)

If you wish, you can hit "generate test data for the store"

Set up webhooks (Basic plan only)

If you have a basic plan, you should also add a manual webhook (not relevant for Shopify plans and above). Go to settings -> notifications -> webhooks.

Click create webhook.

In the event specify “Order update”,

In the URL - https://shopify.apps.digitalwallet.cards/webhook

In the Webhook API version select Latest.

Click Save.

The shop will be generated. Now let's go to the dev dashboard again. In the dev dashboard, click Apps, choose the app that we just created, then click Install app.

The shop will be created, and you will see this screen.

If you have multiple stores, you'll be asked to choose which one to install the app on.

When you click Install, Shopify shows a confirmation screen listing the data the app needs access to, along with an orange "This app hasn't been reviewed" warning. This is expected for custom apps — they aren't submitted for Shopify's App Store review process. Review the requested permissions and click Install to confirm.

Step 2. Get the Access Token

The app is now installed. Next, let's get the credentials needed for the access token.

Open the app you just created, then click Settings in the left menu.

Here are the credentials you'll need — Client ID and Secret. Copy them.

Create a text file with the following command, replacing the placeholders with your own values, then run it in Terminal:

curl -X POST \
  "https://{your-shop-address}/admin/oauth/access_token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id={your_client_id}" \
  -d "client_secret={your_client_secret}"

• {your-shop-address} — your Shopify store's admin address (e.g. your-store.myshopify.com), copied from Settings.

• {your_client_id} and {your_client_secret} — the Client ID and Client secret from your custom app's API credentials page (Step 1).

Run it in the terminal. Copy the access token.

You can reveal an Admin API access token only once. If you lose it, you'll need to uninstall and reinstall the app to get a new one — this also removes any webhooks registered under the old token, so they'll need to be set up again.

Step 4. Connect the app in Boomerangme

Let's go to Boomerangme Shopify integrations. Choose the loyalty card (the card must be activated), then enter your shop URL and access token as shown in the screenshot.

Select a card template (stamp, cashback, discount, or reward).

For stamp and reward cards, this integration only accrues stamps/points automatically if the card's accrual rule is set to Visit (see the note further below). With any other accrual rule (Stamps, Spend, or Products), points must be accrued manually using the Boomerangme Scanner app in-store instead.

Enter the Shopify store Url without https:// and Access Token

Choose the Location, then choose the Accrual rules. Then choose products in your shop. (For these products, accumulation will occur if they are purchased.)

Select an accrual rule (for the whole cheque; for a cheque over a certain amount; for certain items)

Select delivery channels for card installation links.

How it works

Once the order has been paid for in your Shopify store, the details of the payment order will be transferred to Boomerang. If the order is canceled, the points will be deducted from the card. The updated balance is automatically reflected on the customer's loyalty card installed on their phone, and the customer will receive a push notification about the change.

If a customer with this phone number and email has a loyalty card, they will be awarded points. If the customer is not in the system, it will be created, the card will be issued, and the link to install the card will be sent to the selected delivery channels (connected mailers in your account are required).

Attention! The currency in the Boomerang account and in the app must be the same.

If you're using a stamp card, open the card settings → Reward Program and set the accrual rule to Visit ("Give stamps based on the customer visits"), then set how many stamps are earned per visit (e.g. 1 visit = 1 stamp). This is required for the Shopify integration to accrue stamps automatically — the other options (Stamps, Spend, Products) won't trigger accrual through this integration.

After placing an order on Shopify, the customer will appear on the Boomerang side, and a card will be issued to them with a stamp applied. If you selected a card delivery method in the integration settings, the customer will receive an SMS or email at that moment with a unique link to set up the card.