Apple Pay on Online Giving Forms

If you use Bloomerang Payments as your processor, you can accept Apple Pay on your online giving forms. If you embed the giving form on your website, Apple must verify your domain before you can accept Apple Pay. This applies to online giving forms that you embed on your website:

Standard forms — Forms that you create and manage in Bloomerang CRM. To embed this form on your website, you download a short JavaScript code snippet from Bloomerang CRM and add it to your website.
Custom self-hosted forms — Forms that you create in Bloomerang CRM, customize outside of Bloomerang CRM, and host on your own domain. To embed this form on your website, you download the full code for the form from Bloomerang CRM and add it to your website.

Domain verification isn't required for other digital wallet payment methods (Google Pay, PayPal, and Venmo). Read more about digital wallets.

Before You Begin

This is a technical task, which means you might need a little help from your IT support provider or web developer.

Before you begin:

Make sure you’re comfortable managing files on your web server. To get your domain verified by Apple, you must add a verification file to your web server. Bloomerang Support does not include direct support for your organization's website. For assistance with your web server files, contact your IT support provider or web developer.
Make sure you have access to the .well-known root folder on your web server. Some website hosting services, such as Wix and Squarespace, do not allow access to the .well-known folder. If you cannot access or add this folder, Apple cannot verify your domain.

Step 1 — Create an Online Giving Form

First, create a new online giving form in Bloomerang CRM. For instructions, view:

Create Online Giving Forms — Standard forms that you create and manage in Bloomerang CRM.
Create, Edit, and Revert Self-Hosted Forms — Forms that you create in Bloomerang CRM, customize, and host.

If you have an existing online giving form on your website, start at Step 3: Download and Embed the Verification File to verify your domain for Apple Pay.

Note: Apple Pay is not available on event registration forms.

Step 2 — Copy the Code to Your Website

Next, copy the form code from Bloomerang CRM to your website. For instructions, view:

Step 3 — Download and Embed the Verification File

Apple must verify your domain before the Apple Pay button can appear on your giving forms.

To start the verification process:

Download the verification file here: https://bloomerang.com/wp-content/uploads/2023/10/apple-developer-merchantid-domain-association.zip
A .ZIP file named apple-developer-merchantid-domain-association.zip downloads to your computer. This file is unique to Bloomerang CRM.

Note: If the file doesn't download, your web browser might have security settings that block .ZIP files. To download this file, copy the link and paste it directly into your browser's search box. Or, use a different browser to download this file.
Open the .ZIP file to extract the file named apple-developer-merchantid-domain-association. This file has no file extension.
On the domain or subdomain where your form lives, look for a folder named .well-known. If this folder doesn’t exist, create it manually. You must create this directory at the root level: example.org/.well-known. Apple later checks this folder for the verification file.
To embed the verification file on your website, copy it to the .well-known folder. Example: example.org/.well-known/apple-developer-merchantid-domain-association
To make sure you can open the verification file, open the URL in a web browser. You should see a long string of numbers.

The verification file never expires, which means you only have to copy it to your website once.

Note: If your organization uses multiple subdomains, you might have to copy the verification file to each subdomain, depending on how web server files are shared throughout your domain. For support, contact your web developer or IT agency.

Step 4 — Contact Bloomerang

After you embed the verification file on your website, email [email protected] to let us know. In your message to us, you must include the link to your domain.

We’ll then attempt to register your domain on our end. If the verification file is in the correct place on your website, we’ll be able to register your domain. If the file isn’t in the correct location, contact your web developer or IT agency to troubleshoot.

After we register your domain successfully, donors see an Apple Pay button on your giving forms. Donors must enable Apple Pay and Apple Wallet on their device and use a supported browser:

Safari
Chrome on iOS 16