Prerequisites and Set up for Apple Pay Integration

To enable Apple Pay on your website:

📘

Notes:

• The file path must be exactly as specified (case-sensitive).
• File hosting is required on websites where PayU Checkout loads as an overlay/iframe. This includes WooCommerce, Magento, and other ecommerce platforms where PayU appears as an overlay, or any website where PayU Checkout iframe is embedded.
• No file hosting required on Shopify, Mobile SDKs (Flutter, Native iOS, React Native), and PayU no-code solutions such as Payment Links, Payment Pages, and Invoices.
• File hosting is required if you use both hosted checkouts and overlay iframe integration on your merchant account. Do not activate Apple Pay if you have both these kinds of checkouts unless you have hosted the file at the exact path.

Domain Verification Process

1. Download the verification file from the following location:

2. Upload the file so that it is hosted the file on your server:
   • Upload the file to this exact path on your website:

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

   • For example, if your domain is https://www.yourstorename.com, the file must be accessible at:

     https://www.yourstorename.com/.well-known/apple-developer-merchantid-domain-association

📘

Ensure correct configuration. When setting up Apple Pay domain verification, follow these requirements:

File Path and Response

• The verification file must be accessible at the exact path /.well-known/apple-developer-merchantid-domain-association.
• The file must return a direct HTTP 200 status code and not a 301, 302, or any 3xx redirects.
• Apple does not support HTTP URL redirects for the domain association file.

Server Configuration

• The file must be served via HTTPS 1.1 protocol.
• The HTTP response must return the file as a binary object, not as HTML or plain text.
• Set the Content-Type header to application/octet-stream to indicate this is a binary file download.

Network Access

• Ensure the file is not behind a firewall or access restrictions.
• If using a firewall, configure it to allow Apple's IP addresses.

3. Verify each domain separately:

   • Repeat this process for all domains and subdomains from where checkout is initiated with an overlay iframe.
   • This includes:
     • Top-level domains (for example, yourdomain.com)
     • Subdomains (for example, shop.yourdomain.com, checkout.yourdomain.com, us.yourdomain.com, uk.yourdomain.com, and so on)

4. Confirm with PayU:

   • After the files are uploaded, notify your PayU Key Account Manager(KAM) or contact PayU Integration Support.
   • PayU will verify the setup and activate Apple Pay on your account.