Skip to main content

How to Integrate Apple Pay with Adyen

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

Updated over a week 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 the Ventrata Payments team 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.


Add Apple Pay Domains

One your Apple Pay payment method has been enabled by Ventrata, you can add or update the domains where your Apple Pay association file is hosted. This allows Apple Pay to be used across multiple websites.

To update your payment gateway:

  1. In the Ventrata dashboard, go to Supplier Settings > Gateways.

    Gateways

  2. Select your existing 'VentrataAdyen' payment gateway.

  3. In the 'ApplePay Domains' field, enter the domain(s) of your website where Apple Pay will be accepted.

    ApplePay Domains

  4. Press the Update Gateway button to save your changes.

    Update Gateway

Did this answer your question?