Skip to content

Add Apple Pay to Embedded Donation Forms

You need to verify the domain where you plan to use Apple Pay to add it to your embedded donation forms. To verify the domain, add the domain association file to your website's file structure and contact our Care team.

This is a security feature made by Apple to ensure that only authorized merchants process payments.

General instructions

To verify your domain on most website providers:

  1. Download the domain association file
  2. On your website, host the file at /.well-known/apple-developer-merchantid-domain-association
  3. Contact our Care team to complete verification and add Apple Pay to your forms

For example, if your website is https://website.org, make that file available at https://website.org/.well-known/apple-developer-merchantid-domain-association.

You should have your website admin create a new folder called .well-known and place the domain association file inside the folder.

We recommend contacting your website administrator or provider if you need help hosting the file on your website.

Note

Apple Pay is available on Apple devices with Safari 17 or later and at least one valid card linked.

WordPress

You can transfer files using SFTP and your preferred client program to host the domain association file on your WordPress site.

However, we recommend using the File Manager plugin to upload and host the file easily.

To add the File Manager plugin:

  1. Go to your WordPress site’s Dashboard
  2. In the menu, select Plugins and Add New
  3. Search for and install File Manager

Install file manager plugin

  1. Once installed, select Activate

Now, you’ll have a new option for WP File Manager in your menu. This plugin lets you easily create folders and upload files to your site.

To upload the domain association file:

  1. In the menu, select WP File Manager
  2. Select the Create New Folder icon and name it .well-known
  3. Within .well-known, create a new folder and name it apple-developer-merchantid-domain-association
  4. Select the Upload File icon and upload the domain association file

Using the file manager plugin

  1. Contact our Care team to complete the verification

Squarespace

Squarespace sites host the required domain association file by default.

Contact our Care team, and they can activate Apple Pay for your embedded form.