This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Adyen

Configure Adyen terminals to display a The Wallet Crew QR code and to trigger Apple Wallet loyalty card notifications through beacons.

Displaying a QR Code on an Adyen Terminal

An Adyen terminal can be configured to display a QR code by following these steps.

Example

Adyen payment terminal screen displaying a QR code in place of the merchant logo
Check that the QR code fills the logo area and stays scannable at terminal size.

Prerequisites

  • Ensure access to the Adyen Customer Area is available.

  • Obtain the QR code image specific to the store from The Wallet Crew administration console (details below).

Steps to Configure the QR Code on the Adyen Terminal

  1. Log in to the Adyen Customer Area Access the Adyen account using the following link: Adyen Customer Area{target="_blank"}.

  2. Navigate to Terminal Settings

    • Go to the In-person Payments section.

    • Select Terminal Settings from the menu.

    • Then Customization menu

  3. Download the QR Code from The Wallet Crew

  4. Upload the QR Code Image

    • Locate the Logo section in the terminal settings.

    • Upload the image of the QR code.

The size requirements for the QR code image depend on the specific terminal model. Refer to the Adyen documentation for exact dimensions.

Adyen terminal customization screen showing the logo upload area and its size requirements
Confirm the uploaded image matches the size expected by the terminal model in use.

How to Set Up Adyen Terminals with Apple Wallet Loyalty Card Notifications Using Beacon Technology

With Beacon Technology (learn more from Apple's documentation), Adyen terminals can send notifications to nearby iPhones that hold an Apple Wallet loyalty card when they are within range (e.g., 50 cm). The setup is described below.

Enhancing Loyalty Card Notifications with Adyen and Apple Wallet

Adyen terminals equipped with beacon technology allow seamless engagement with customers by delivering real-time notifications to their Apple Wallet loyalty cards. This integration is a powerful tool for businesses to enhance customer experience and boost loyalty program engagement.

Key Benefits:

  • Real-Time Engagement: Notify customers about loyalty benefits or promotional offers as they approach the terminal.

  • Seamless Integration: Works directly with Apple Wallet and Adyen terminals.

  • Customizable Notifications: Tailor messages to match the brand tone and context.

Example

iPhone lock screen showing a beacon-triggered Apple Wallet loyalty card notification
This is what the customer sees when the phone comes within range of the terminal.

Steps to Configure Beacon Technology

1. Log in to the Adyen Customer Area

2. Enable Beacons in Adyen Terminal Settings

  • Navigate to the In-person Payments section.

  • Select Terminal Settings and then go to the Connectivity tab.

  • In the Beacon section:

    • Enable Beacons by toggling the option.

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

3. Configure Beacon Settings in The Wallet Crew

  • Edit a Template:

    • Open the Apple tab.

    • Navigate to the Beacon section.

    • Enter the same UUID, Major, and Minor values configured in the Adyen administration console.

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

4. Test the Beacon Setup

When an iPhone is within range (approximately 50 cm) of the configured Adyen terminal, a notification should appear displaying the label text.

Pro Tip: If the notification does not appear as expected, ensure the beacon settings are consistent across the Adyen and The Wallet Crew configurations. Use a testing environment to refine configurations before deploying to production.

Optimizing Notifications for Apple Wallet Loyalty Cards

  • Personalize the Message: Ensure that the notification text resonates with the audience. Use promotional hooks or loyalty rewards to encourage engagement.

  • Leverage Analytics: Use Adyen’s reporting tools to monitor engagement and refine strategies based on customer interactions.

  • Stay Updated: Regularly update the beacon settings to reflect seasonal campaigns or business changes.

Additional Notes

  • Testing range and compatibility may vary depending on the environment and iPhone model. Adjust settings if necessary.

  • Refer to Apple’s Beacon Technology Documentation for advanced customization and troubleshooting.

By utilizing Adyen terminals with Apple Wallet loyalty cards and beacon technology, businesses can deliver unparalleled customer experiences, driving repeat visits and increasing loyalty program participation.

Last updated