How to enable Apple Pay as a payment method

Blanca Castillo
Blanca Castillo
  • Updated

What does it mean?

Apple Pay is a secure and convenient mobile payment and digital wallet service provided by Apple. It allows customers to make seamless, one-touch payments using their Apple devices, significantly improving conversion rates by removing the need for manual card entry.

Apple Pay is included by default as part of the Palisis Marketpay functionality. For most standard setups, no additional configuration is required to start accepting payments.

However, if your webshop is embedded into an iframe, Apple’s security protocols require a specific manual activation process. In this instance, Apple Pay will not function automatically.

 

What should I do?

To enable Apple Pay for an iframe-embedded shop, please contact our Support Team to request activation. To expedite your request, please ensure the following technical requirements are met:

Customer-side hosting (Domain verification)

Apple requires a domain association file to be hosted on your primary domain (the site where the iframe is embedded).

  • Action: Download the Apple verification file: Apple Developer Merchant ID Association.

  • Placement: This file must be placed in a folder named .well-known within your hosting root directory.

  • Example path: https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association

  • Important: The dot (.) before the well-known folder name is strictly required for Apple to recognise the path.

Palisis-side configuration (Adyen)

Once the file is hosted on your domain, contact our Support Team here to configure your domain within Adyen.

  • Information required: Please provide our Support Team with the full Primary Domain URL where the iframe is hosted.

  • Internal process: Our team will then initiate the necessary backend configuration via a technical request to our development team.

Browser Compatibility & Iframe Attributes

To show Apple Pay correctly within an iframe element when the shopper is using Safari, the following technical requirement must be met:

  • For Safari 17 and later (iOS 17+, macOS 12+): You must add the allow attribute to the iframe to permit communication with Apple Pay APIs: <iframe allow="payment"></iframe> (Apple Pay Component|Adyen doc).

Note: These steps are exclusively required for iframe scenarios. Standard implementations of Palisis Marketpay do not require this manual domain association.