> 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/adyen.md). # Adyen Configure Adyen terminals to display a QR code of The Wallet Crew and to trigger Apple Wallet loyalty pass notifications through beacons. Adyen terminals can show a QR code that opens a wallet pass, and can trigger a notification on nearby iPhones that hold an Apple Wallet pass. The two setups are independent: [QR code on the terminal](#display-a-qr-code-on-an-adyen-terminal) and [beacon notifications](#send-apple-wallet-notifications-with-beacons). ## Prerequisites * Access to the [Adyen Customer Area](https://ca-live.adyen.com/ca/ca/overview/default.shtml). * Access to the admin console. ## Display a QR code on an Adyen terminal The terminal shows the QR code in place of the merchant logo.

Check that the QR code fills the logo area and stays scannable at terminal size.

### Steps 1. **Open the terminal settings** * Go to **Devices → Device settings** ([Adyen documentation](https://docs.adyen.com/point-of-sale/design-your-integration/determine-account-structure/configure-features)). * To set the logo for one terminal only, go to **Devices → Device list**, select the **Terminals** tab, then select the terminal. 2. **Download the QR code from The Wallet Crew** * In the admin console, open [**Enrollments → Links & QR codes**](https://admin.thewalletcrew.io/tenant/~/enrolments/redirects). If the store has no link yet, create one first, as described in [Links & QR codes](/guides-enrolment/enrolment/enrolment-form/redirect.md). * Download the QR code image and save it in an accessible location. 3. **Upload the QR code image** * In the **Device** category, locate the **Logos** setting. It has one entry per terminal model. * Upload the image of the QR code for the terminal model in use. The terminal shows it as its standby screen. {% hint style="info" %} The size requirements for the QR code image depend on the specific terminal model. Refer to the Adyen documentation for exact dimensions. {% endhint %}

Logo upload area and size requirements of the terminal.

## Send Apple Wallet notifications with beacons With **beacon technology** ([learn more from Apple's documentation](https://developer.apple.com/ibeacon/)), Adyen terminals can send notifications to nearby iPhones that hold an Apple Wallet loyalty pass when they are within range of the terminal. The setup is described below.

### Steps #### 1. Enable beacons in Adyen terminal settings * Go to **Devices → Device settings → Device connectivity** ([Adyen documentation](https://docs.adyen.com/point-of-sale/design-your-integration/network-and-connectivity/set-up-beacons)). * In the **Beacons** section: * Turn on **Enable beacons**. * Specify a unique **UUID**. A new one can be generated with the reset button from The Wallet Crew, or an existing beacon configuration value can be reused. * Set the **Major** and **Minor** values (any number between 0 and 65535).

Adyen beacon settings showing the UUID, Major, and Minor fields — Note the UUID, Major, and Minor values here: they must be repeated identically in The Wallet Crew.

#### 2. Configure beacon settings in The Wallet Crew * In the admin console, open [**Wallet → Templates**](https://admin.thewalletcrew.io/tenant/~/templates). * Edit a **pass template**: * Open the **`Apple`** tab. * Navigate to the **Beacons** section. * Enter the same **UUID**, **Major identifier** and **Minor identifier** values configured in the Adyen Customer Area. * Specify a **Label**. This is the text that will be displayed on the iPhone notification.

Beacon section of a pass template in The Wallet Crew, with UUID, Major, Minor, and Label fields — Check that these values match the Adyen terminal exactly, and that the label reads well on a lock screen.

#### 3. Test the beacon setup When an iPhone is within range of the configured Adyen terminal, a notification should appear displaying the label text. If the notification does not appear as expected, check that the beacon settings are consistent across the Adyen and The Wallet Crew configurations. Use a testing environment before deploying to production. Testing range and compatibility may vary depending on the environment and iPhone model. Adjust settings if necessary. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.thewalletcrew.io/connectors/pos/adyen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.