Skip to main content

Embedded Apple Pay

If you embed the Checkout Page in your own site using an iframe, you need to register your domain with Apple Pay before the Apple Pay button will appear.

info

You only need these steps if you embed the Checkout Page in an iframe. If you redirect customers to the Checkout Page, Apple Pay works without any setup.

If you are using the Checkout SDK (Embedded Checkout) instead, this page doesn't apply — the SDK's express component handles Apple Pay for you without a domain registration file.

How it works​

Before you start:

  • Apple Pay must be enabled on your Monek account. If you don't see the Apple Pay Domain Registration section in the Portal, contact Monek Support.
  • Your website must use HTTPS.
  • Customers need Safari 17 or later (iOS 17 or later, or macOS with Safari 17 or later). Older versions of Safari don't support Apple Pay inside an iframe.

Step 1: Host the domain registration file​

Download Monek's domain registration file. It tells Apple that Monek is authorised to process Apple Pay payments on your website:

Domain Registration File: apple-developer-merchantid-domain-association

Put the file in this public location on every domain you'll register, including subdomains:

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

For example, if you register both yourdomain.com and shop.yourdomain.com, the file must be available on both. Apple checks each domain separately.

Check each one by opening the address in your browser. The file should download.

Apple won't register a domain unless it can find this file.

Step 2: Register your domain​

  1. Log in to the Monek Portal and go to Settings → Integrations.
  2. In the Apple Pay Domain Registration section, click the (+) icon.

Apple pay integrations tab

  1. Add each domain (including subdomains) where you'll embed the Checkout Page, and your website's homepage URL.
  2. Click Save. Monek sends the registration to Apple. If Apple can find the file from Step 1, your domain appears in the list.

Apple pay new domain

Step 3: Embed the Checkout Page​

Embed the Checkout Page in an iframe on your website. Apple Pay then appears as an express checkout option.

<iframe src="https://elite.monek.com/Secure/Checkout.aspx?PaymentToken=YOUR_TOKEN" allow="payment"></iframe>
warning

You must include allow="payment" on the iframe. Without it, Safari won't show the Apple Pay button, even if your domain is registered.

Troubleshooting​

Apple Pay button not appearing​

Check the following:

  1. Browser: Apple Pay in an iframe needs Safari 17 or later, on iOS 17 or later, or macOS with Safari 17 or later. Check your test device.
  2. Apple Pay on your account: Confirm the Apple Pay Domain Registration section appears in the Portal. If not, contact Monek Support.
  3. Domain registration: Confirm your domain appears in the Apple Pay Domain Registration list in the Monek Portal.
  4. Iframe attribute: Make sure your iframe includes allow="payment".
  5. Domain registration file: Check the file opens at https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association on the domain where the iframe is shown.
  6. HTTPS: The page must be served over HTTPS. Apple Pay won't work over HTTP.

Domain registration failed​

If you see an error when you register a domain:

  1. Check the domain registration file is in the correct location on that domain and is publicly accessible.
  2. Wait a few moments and try again. DNS and server changes can take time to take effect.
  3. Check the domain is spelled correctly and matches your website address.
  4. Contact Monek Support if the problem continues.

Apple Pay works on redirect but not in iframe​

If Apple Pay works when you redirect customers to the Checkout Page but not when it's embedded, the cause is usually one of:

  • Missing allow="payment" on the iframe
  • Safari older than version 17
  • Domain not registered with Apple Pay
  • Domain registration file not on that domain

Check each of these against the steps above.