Verify a Domain for Apple Pay

Apple requires verification of every web domain where Apple Pay appears. This includes top-level domains (such as myorganization.org) and subdomains (such as donate.myorganization.org).

Note: Forms that Blackbaud hosts, such as those with URLs that include host.nxt.blackbaud.com or blackbaudhosting.com, are already verified. You do not need to verify these domains.

The following form types require you to host a verification file and verify your domain from the Blackbaud Merchant Services Web Portal:

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

  • Raiser’s Edge NXT Embedded Standard Donation Forms, Embedded Event Registration Forms, and Optimized Donation Forms that launch from your website

  • Online Giving for Blackbaud CRM and Altru Embedded Standard Donation Forms and Optimized Donation Forms that launch from your website

  • Custom online forms using new checkout through the Payments API

Forms that use 'classic' Blackbaud Checkout use different setup requirements. For more information, see Set Up Digital Wallets for Online Forms.

Step One: Host the Verification File

A website admin (or similar resource) must 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. If you previously hosted the classic version, delete it and replace it with the new version.

  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.

    Note: Check your hosting provider’s documentation for instructions on how to access or create the /.well-known folder.

Step Two: Verify your Domain

After you host the verification file, verify your domain.

  1. Sign in to the Blackbaud Merchant Services Web Portal.

  2. From Settings, expand Payment domains.

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

  3. Select Add domain.

  4. Enter your domain name.

    Note: Enter only the domain — don't include http:// or https://.

  5. Confirm that the verification file is hosted at the correct path.

  6. Select Save and verify.

  7. Repeat these steps for each domain and subdomain where Apple Pay should appear.

    Note: www is a subdomain, so you must verify it separately. For example, add both myorganization.org and www.myorganization.org.

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

FAQ

If your form URL includes a Blackbaud domain, such as host.nxt.blackbaud.com or blackbaudhosting.com, it is hosted by Blackbaud and already verified. You don't need to host the verification file or complete verification.

No. Apple Pay is supported on other form types and solutions. Those solutions use different setup requirements. For other form types, see Set Up Digital Wallets for Online Forms.

Yes. Verify each domain and each subdomain where Apple Pay appears. This includes the subdomain www.

The domain won't verify and Apple Pay won't appear. Confirm that the file is in the .well-known directory and that the URL matches the expected format.

No. Apple doesn't support domain verification for environments that are not publicly accessible or that require authentication.

No. You only need to verify a domain once. After verification, you can use the domain with multiple Blackbaud Merchant Services accounts.