Clarification on Apple Pay Domain Verification File Behavior

Question

Created Dec ’24

Replies 1

Boosts 0

Participants 2

I'm implementing Apple Pay in my Flutter web app and I'm following the guidelines for domain verification using the apple-developer-merchantid-domain-association file.

When I access the file at https://mydomain.com/.well-known/apple-developer-merchantid-domain-association through my web app, the browser silently downloads the file instead of displaying its content on the webpage.

My question is:

Is this the expected behavior for the apple-developer-merchantid-domain-association file? Should the browser download the file silently, or is there another step required, such as displaying the content on the webpage for verification purposes? I've consulted some resources and they indicate that the file download is the correct behavior. However, I'd appreciate confirmation from the community to ensure I'm implementing the verification process correctly.

Summary is how do we know if apple has verified it?

Boost

Answer 1

DTS Engineer OP

Apple

3w

Hi @umertap,

You wrote:

[...] Is this the expected behavior for the apple-developer-merchantid-domain-association file? Should the browser download the file silently, or is there another step required, such as displaying the content on the webpage for verification purposes? I've consulted some resources and they indicate that the file download is the correct behavior. However, I'd appreciate confirmation from the community to ensure I'm implementing the verification process correctly.

Yes, the file download is the expected behavior. Please see the technote below for the configuration process and more information about validating your merchant domains for Apple Pay:

TN3173: Troubleshooting issues with your Apple Pay merchant identifier configuration

https://developer.apple.com/documentation/technotes/tn3173-troubleshooting-issues-with-your-apple-pay-merchant-id-configuration#Domain-verification-issues

Then, you wrote:

[...] Summary is how do we know if apple has verified it?

Use the Apple Developer website to find your merchant ID configuration. If you haven't created a merchant ID, please see the following Developer Account Help page:

Configure Apple Pay: Create a merchant identifier

https://developer.apple.com/help/account/capabilities/configure-apple-pay#create-a-merchant-identifier

From the merchant ID configuration page, you'll find a Merchant Domains section where you can verify your domain manually, by clicking the "Verify" button once your file is placed in the /.well-known/ folder in the HTTP root of your domain server.

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

0