Apple Pay

Apple Pay needs you to host a file in your domain.

Domain Verification Process:

1. Download the

   verification file

   .

2. Host the file on your server.

   • Upload the file to this exact path on your website:
   copy

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

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

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

3. 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 file must have Content-Type: text/plain in the header.
   • The file must be externally accessible (not behind authentication).
   • The file must not be password protected.
   • The file must not be behind a proxy or redirect.

   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

     .

4. After completing the above steps, please contact the

   Support team

   to enable Apple Pay.

If you have uploaded the file or have not requested to opt out of Apple Pay, we will assume you are okay with

If the Apple Pay button is not appearing, check for these common issues:

• Verify that your domain verification file is correctly hosted and accessible.
• Ensure your website is using HTTPS with proper TLS configuration.
• Confirm that international payments feature is enabled.
• Check if the customer's device supports Apple Pay.

Domain verification failures typically occur due to the following reasons:

• The verification file must return an HTTP 200 status code (not 301 or 302 redirects).
• The file path must be exactly /.well-known/apple-developer-merchantid-domain-association.
• The file must be accessible via HTTPS (not HTTP).
• The file content must exactly match what Razorpay Curlec provided, with no modifications or extra characters.

No code changes are required for Standard Checkout integration. Once domain verification is complete and Apple Pay is enabled on your account, it will automatically appear as a payment option for eligible customers.

There are no additional charges for Apple Pay transactions. Standard Razorpay Curlec payment processing rates apply, same as regular card transactions.

Apple Pay uses device-specific tokens that are automatically available for repeat purchases. Customers do not need to manually save payment details as their Apple Wallet handles this seamlessly.

Apple Pay transactions can be identified by checking the payment notes field in the API response or webhook payload:

"notes": {
     "provider": "apple_pay"
   }

This provider field will always contain apple_pay for Apple Pay transactions, making it easy to distinguish them from regular card payments.

There are structural differences between Apple Pay and standard card payment webhook events:
Apple Pay Payment:

"notes": {
     "provider": "apple_pay"
   }

Card Payment:

"notes": [],
     "token_id": "token_RIa2YPNM92wfzv"

Key differences:

• Apple Pay includes provider: "apple_pay" in the notes field.
• Card payments may include a token_id for saved cards.

Check if the file is hosted correctly at your domain by visiting: https://www.yourstorename.com/.well-known/apple-developer-merchantid-domain-association.

Follow the

On Mobile:

• Open Safari in incognito mode on an iPhone with Apple Pay configured.
• Visit your checkout page.
• Apple Pay should appear at the top of payment options and under the cards menu.

On Desktop:

• Use Safari on macOS with Apple Pay configured.
• Ensure you are signed into your Apple account.
• Apple Pay will be visible if you have cards linked to your Apple account.

No, Apple Pay does not work in test mode.