Skip to main content
All CollectionsWalkthroughsPaymentsDigital Wallets
How to Integrate Apple Pay with Adyen
How to Integrate Apple Pay with Adyen

Provide your customers a secure and seamless payment experience on the web.

Lucia Burin Sestakova avatar
Written by Lucia Burin Sestakova
Updated over 4 months ago

Apple Pay provides a secure and seamless payment method on the web.

πŸ“’ NOTE

Please note that Apple Pay is supported only on iOS devices and the Safari web browser. Learn more about Apple Pay compatibility here.

When the customer selects Apple Pay, they are presented with a payment sheet where they choose a card and provide contact details and shipping address. Then they are prompted to authenticate the payment through Face ID or Touch ID.

Apple Pay supports liability shift for American Express, Discover, JCB, Mastercard, and Visa cards (as of version 16.2 the liability shift applies globally).


Host the domain association file on your website

πŸ“’ NOTE

You need access to the domain and subdomain settings where Apple Pay will be used, as well as knowledge of DNS configuration. If you lack this access or expertise, please ask your webmaster for assistance.

  1. Download and unzip the domain association file.

  2. Host the domain association file on each domain you want to use, including subdomains. To host the file, use the exact file name apple-developer-merchantid-domain-association under the following path:

    /.well-known/apple-developer-merchantid-domain-association


    πŸ“’ NOTE

    DO NOT COPY the text from the file, but rather unzip and host the file as it is.


  3. The file must:

    • Have Content-Type: text/plain in the header.

    • Be externally accessible.

    • Not be password protected.

    • Not be behind a proxy or redirect.

    • Be hosted with the Unix line ending.

πŸ“˜ EXAMPLE

Here is an example of a working domain association file. Notice the URL structure, that the file is accessible from anywhere and no password is necessary to view it.


Verify that the File is Correctly Hosted

  1. Run a cksum on the hosted file using the code below.

    curl -s https://eu.adyen.link/.well-known/apple-developer-merchantid-domain-association" | cksum


    πŸ“’ NOTE

    Instead of https://eu.adyen.link/, use your own domain.


  2. Your cksum output should match that of the working domain association file, which is 2304607924 9094.

πŸ“— TIP

For more troubleshooting tips visit this Adyen article.

Once the file is correctly hosted, let your Ventrata Payments Operation Specialist know. They will then proceed with the necessary steps for the setup.

They will set up your Apple Pay mobile payment solution in Adyen. You will receive a message from Ventrata when your Apple Pay payment method is ready and operational.

Did this answer your question?