---
title: "Enable Apple Pay on the overlay checkout"
slug: "enable-apple-pay-on-the-overlay-checkout"
updated: 2026-08-04T04:14:36Z
published: 2026-08-04T04:14:36Z
canonical: "mysupport.roller.software/enable-apple-pay-on-the-overlay-checkout"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable Apple Pay on the overlay checkout

# 

Improve your guest checkout experience by offering Apple Pay as a fast, secure payment option.

This guide shows you how to enable Apple Pay on your overlay checkout and verify it’s working correctly.

> [!NOTE]
> Apple Pay is currently supported on the overlay checkout experience for venues using progressive checkouts and ROLLER Payments.

## Before you start

Before you start, make sure you have:

- Set up your progressive checkout.
- Added the overlay checkout added to your website.
- Access to your website hosting (or a web developer who can upload files).
- Apple Pay enabled with Adyen (your payment partner).

> [!WARNING]
> If your checkout runs on a ROLLER custom domain (eg [tickets.yourvenue.com](http://tickets.yourvenue.com)) rather than embedded on your own site, the Apple Pay setup is slightly different. See the instructions for [Configure Apple Pay for custom domains](/v1/docs/set-up-a-custom-domain-for-your-online-checkout#h_01J168TXX1D33BCPH4H16V9Y1B) instead.

## How Apple Pay works with the overlay checkout

Apple Pay requires a **domain association file** to confirm your website domain is authorized to display Apple Pay.

This file must:

- Be uploaded to your website under the **.well-known** directory.
- Be publicly accessible.
- Be whitelisted by Adyen before Apple Pay will appear.

Apple Pay will not display until this process is complete.

**Request your domain association file**

To enable Apple Pay:

1. Contact the support team to request your Apple Pay domain association file. The file is supplied by Adyen and sent to you by the ROLLER support team. Alternatively, you can access the most recent version of this file on [Adyen’s website](https://docs.adyen.com/payment-methods/apple-pay/web-drop-in/#test-and-go-live).
2. Upload the file to your website under the **.well-known** directory.
3. Let the ROLLER support team know once the file has been uploaded.
4. The support team will coordinate with Adyen to whitelist your domain.

Once your domain is whitelisted by Adyen, Apple Pay will become available on your overlay checkout.

**Ensure your domain association file is in the correct location**

Incorrect placement of the **.well-known** folder is a common cause of Apple Pay not appearing.

If your checkout is launched from a subdirectory (eg. example.com/location-name), ensure the domain association file is accessible relative to the domain structure being used.

**For example:**

- If your checkout runs under example.com, the file must sit correctly under that root domain.
- If your website uses subdirectories, confirm the file is still accessible at the required .well-known path.

> [!NOTE]
> If unsure, please ask your web developer to confirm the file location.

**Verify your domain setup**

After uploading the file:

1. Open the file URL directly in a browser.
2. Confirm the file loads without redirect. Confirm the content type is **text/plain**.

Then notify the support team so they can confirm whitelisting with Adyen. Apple Pay will not appear until whitelisting is complete.

**Add Apple Pay as a payment method**

Ensure that Apple Pay is available as a checkout payment method in payment settings.

![List of payment methods with Apple Pay highlighted as pending option.](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image (3) 4.png)

> [!NOTE]
> Learn how to do this task in the guide [Add payment methods with ROLLER Payments](/v1/docs/add-online-payment-methods-with-roller-payments).

**Test Apple Pay**

Apple Pay will only display when:

- You are using a supported Apple device.
- You are using Safari.
- Apple Pay is set up on the device as a payment method.
- Your domain has been successfully whitelisted.

If all requirements are met, Apple Pay will appear as a payment option on your overlay checkout

## Troubleshooting Apple Pay on overlay checkout

If Apple Pay is not showing, check the following:

- The domain association file is uploaded under .well-known.
- The file is publicly accessible.
- The file loads without redirect.
- The content type is text/plain.
- Apple Pay is enabled in Adyen.
- You are testing on a supported Apple device using Safari.
- The support team has confirmed your domain is whitelisted.

> [!WARNING]
> If Apple Pay does not appear after checking the above steps, contact the [ROLLER support team](/v1/docs/contact-roller-support).