Verify a Payment Domain

To display Apple Pay on the following form types, add and verify your domain through the Blackbaud Merchant Services Web Portal:

  • Luminate Online forms that use new checkout in a custom secure domain

  • Online Giving Optimized Donation Forms launched from links or buttons on your organization's website

    Note: An improved checkout experience is coming soon to Standard Donation Forms! To ensure a smooth transition, you can verify with the new Apple Pay verification file now, even if your form still uses 'classic' Blackbaud Checkout. Your domain stays registered with Apple even after you delete the 'classic' verification file, so it won’t affect your current setup.

You only need to verify a domain once, even if you have multiple Blackbaud Merchant Services accounts. Also, forms that are hosted by Blackbaud or launched from Blackbaud-hosted URLs (such as those containing host.nxt.blackbaud.com or blackbaudhosting.com) are already verified with Apple.

Tip: To learn how to set up Apple Pay for other solutions and form types, see Digital Wallets.

Step one: Host the verification file on your website

A website administrator or similar resource should follow these steps to upload the verification file to your website:

  1. Download the Apple Pay verification file (new checkout version).

    Warning: This file differs from the 'classic' Blackbaud Checkout version and is valid for Luminate Online forms, Optimized Donation Forms, and Standard Donation Forms (coming soon). If you previously hosted the 'classic' version, delete it and replace it with the new one.

  2. Place the file in the .well-known folder on your website. For example, the resulting URL should look like: https://myorganization.com/.well-known/apple-developer-merchantid-domain-association.

Step two: Verify your domain

After you upload the Apple Pay verification file, verify your domain.

  1. From the Blackbaud Merchant Services Web Portal, under Control panel, Settings, expand Payment domains.

    Tip: Don't see this option? Contact your system admin for rights to manage wallet configurations.

  2. Select Add domain.

  3. Enter the domain where Apple Pay should appear and confirm the verification file is uploaded to the correct path.

  4. Select Save and verify.

  5. Repeat for each domain (such as myorganization.org) and subdomain (such as donate.myorganization.org) where Apple Pay should appear.

After your verify your domain, test your form by viewing it from a compatible Apple device with latest version of iOS.