Apple Pay Domain Verification

For Embedded Integration Apple Pay, Apple requires domain verification on your merchant domain. Hosted checkout merchants do not need this — DigetPay manages the checkout domain.

Hosted checkout: No action needed. See Apple Pay on Hosted Checkout.

The domain association file must be served over HTTPS at the exact path Apple expects — no redirects.

Domain verification failure prevents Apple Pay from appearing on your checkout. Test the file URL in a browser before go-live.

Verification flow

flowchart LR
  A[Obtain association file] --> B[Upload to .well-known/]
  B --> C[Verify in Apple Developer]
  C --> D[DigetPay registers domain]
  D --> E[Apple Pay enabled]

Step 1 — Obtain the association file

Contact DigetPay integration support to obtain:

apple-developer-merchantid-domain-association

For production, DigetPay coordinates registration with Apple using your merchant ID.

Step 2 — Host the file

Place the file at:

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

Requirement	Detail
Path	`/.well-known/apple-developer-merchantid-domain-association`
Protocol	HTTPS only
Content-Type	`application/octet-stream` or `text/plain`
Redirects	Must not redirect — serve file directly

Step 3 — Verify in Apple Developer portal

Log in to Apple Developer.
Navigate to Certificates, Identifiers & Profiles → Merchant IDs.
Select your merchant ID → Merchant Domains.
Add your domain and click Verify.
Apple fetches the association file from your .well-known path.

Staging vs production

Environment	Notes
Fin staging	Test with staging merchant ID and staging domain
Production	Production merchant ID + live domain — contact DigetPay before go-live

Environments Overview →

Troubleshooting

Issue	Fix
404 on association file	Check file path and web server config
Redirect detected	Serve file directly — no 301/302
Verification timeout	Ensure firewall allows Apple crawlers
Button still missing	Confirm DigetPay registered your domain

Next steps

Apple Pay Embedded

Full embedded Apple Pay guide.

Apple Pay Code (PHP)

Implementation example.

Go-Live Checklist

Production readiness.