> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/connectors/pos/shopify-pos.md).

# Shopify POS

Configure The Wallet Crew scanner tile in Shopify POS to scan digital wallet passes, identify customers, and verify pass details at checkout.

## Scan wallet passes with Shopify POS

The Wallet Crew scanner tile adds wallet-pass scanning to Shopify POS. Store staff can scan a customer's digital pass during checkout. Shopify POS then identifies the customer and displays the available details.

This guide covers tile setup, permissions, and in-store validation. For wallet enrolment and online “Add to Wallet” buttons, see [Shopify](/connectors/e-commerce/shopify.md).

<details>

<summary><strong>Real-world examples</strong></summary>

* A loyalty member presents a wallet pass at checkout for identification.
* Store staff scan a pass before applying member-specific benefits.
* A retail team confirms the pass details before completing a transaction.

</details>

### Prerequisites

The tile requires:

* Shopify POS installed on the store device.
* The Wallet Crew app available in Shopify POS.
* Camera access enabled for Shopify POS.
* A test pass with a visible QR code.

{% hint style="info" %}
The POS device must have an available camera. Camera permissions are managed by the device operating system.
{% endhint %}

### Add the scanner tile

The tile gives store staff a direct entry point from the Shopify POS home screen.

{% stepper %}
{% step %}

#### Open tile management

1. Open **Shopify POS** on the store device.
2. Select **Settings**.
3. Select **Manage tiles**.
   {% endstep %}

{% step %}

#### Add The Wallet Crew tile

1. Select **Add tile**.
2. Select **App**.
3. Select **The Wallet Crew** from the available apps.
   {% endstep %}

{% step %}

#### Enable camera access

1. Return to the Shopify POS home screen.
2. Open the **The Wallet Crew** tile.
3. Allow camera access when prompted.
   {% endstep %}
   {% endstepper %}

### Scan and verify a pass

Scanning validates that the tile can read a pass during a real checkout flow.

1. Open the **The Wallet Crew** tile in Shopify POS.
2. Point the POS camera at the pass QR code.
3. Confirm Shopify POS identifies the customer.
4. Confirm the expected customer details appear before checkout.

Test with an active pass on a physical device. A printed code may not reproduce the screen brightness and focus conditions of a live scan.

### Troubleshooting

#### The Wallet Crew tile is unavailable

Confirm that The Wallet Crew appears in the Shopify POS app list. If it does not, verify the app installation and the Shopify POS account used on the device.

#### The camera does not open

Check the device-level camera permission for Shopify POS. Close and reopen the app after granting access.

#### The pass does not scan

Clean the camera lens and increase the pass screen brightness. Keep the QR code fully visible inside the scanner frame. Test with another active pass to isolate a pass-specific issue.

## FAQ

<details>

<summary><strong>What does the scanner tile do?</strong></summary>

The tile scans a customer's digital wallet pass in Shopify POS. It identifies the customer and displays their details for verification at checkout.

</details>

<details>

<summary><strong>Is camera access required?</strong></summary>

Yes. Shopify POS needs camera access to scan the pass QR code. Grant the permission when opening the tile.

</details>

<details>

<summary><strong>How should the setup be tested?</strong></summary>

Use an active pass displayed on a phone. Scan its QR code and confirm the correct customer details appear in Shopify POS.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/connectors/pos/shopify-pos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.