# Shopify POS

Log in to your Shopify account.

Next, go to settings -> Apps and sales channels -> Develop apps -> Create an app.

<figure><img src="/files/HtzagJxupnsNmwI2UuKe" alt=""><figcaption></figcaption></figure>

Name your app.

Go to Configuration -> Admin API integration. Select the following Admin API access scopes:

read\_products

read\_orders

read\_customers

read\_returns

<figure><img src="/files/oMoG8Og9yek31PqZ5L9V" alt=""><figcaption></figcaption></figure>

Next go to the Overview section and click Install app.

<figure><img src="/files/E1i1JnCBD0eJdKbrnSBH" alt=""><figcaption></figcaption></figure>

Save the Access token (needed to connect the app in Boomerang).

**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.

<figure><img src="/files/erZu9qR1KHDLJN4zFayt" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/t4ZQGqCp8ujjnUYj6RSG" alt=""><figcaption></figcaption></figure>

Click Save.

**The following is the instruction for all plans**:

Now in the Boomerang account, go to integrations and connect the Shopify app.&#x20;

<figure><img src="/files/ofhTTOHCTojH750GyIZG" alt=""><figcaption></figcaption></figure>

Select a card template (stamp, cashback, discount or reward). Note with stamp and points mechanics (in stamp and reward cards) accrual should be done through the scanner, automatic accrual will not be done through the marketplace.&#x20;

Enter the Shopify store Url **without https\://** and Access Token (Admin API access token).

<figure><img src="/files/nWgs9FrhHwDiAASSmsB2" alt=""><figcaption></figcaption></figure>

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

<div><figure><img src="/files/ONN3DIjbI7r01rbe4Bkq" alt=""><figcaption></figcaption></figure> <figure><img src="/files/62lrtDyDybaTHFaTmfAp" alt=""><figcaption></figcaption></figure> <figure><img src="/files/hArWGB9I2T0TiPn4dvKm" alt=""><figcaption></figcaption></figure></div>

Select delivery channels for card installation links.

<figure><img src="/files/O2QjYtckt5RCBBosClK2" alt=""><figcaption></figcaption></figure>

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.

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.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.boomerangme.cards/marketplace/shopify-pos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.