Well Known

Overview

Aurora Commerce allows you to upload well-known certificates and verification files to your storefront through your provided FTP account. Well-known files are often required by third-party services like Apple Pay, Google, and other services to verify domain ownership or enable specific functionality. These files are typically accessed through the .well-known directory at the root of your domain.

📘

The system uses a rewrite rule to map requests to .well-known to files uploaded in the _uploads/well-known directory via your FTP account. If the directory doesn't exist you may create it.

Guidelines

When uploading well-known files, follow these important guidelines:

• Files should be uploaded to the _uploads/well-known directory via FTP, not directly to a .well-known directory.
• The system will automatically serve these files when they are requested via the .well-known URL path.
• Take a backup of any existing files before making changes to ensure you can revert if needed.
• Test all uploads on a staging environment before applying to production.

Content Type Considerations

Please note the following important considerations regarding content types:

• Files with recognized extensions (e.g., .txt, .json) will automatically be served with the appropriate Content-Type header.
• Files without extensions (such as apple-developer-merchantid-domain-association) will be served without a Content-Type header by default.
• Some services, like Apple Pay, may require specific Content-Type headers (e.g., text/plain) for their verification files.

👍

If your third-party service requires specific Content-Type headers for files without extensions, please contact Aurora Commerce.