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

  • Raiser's Edge NXT — Embedded Standard Donation Forms, embedded Event Registration Forms, and Optimized Donation Forms launched from links or buttons on your organization's website

  • Online Giving for Blackbaud CRM and Altru — Embedded Standard Donation Forms and Optimized Donation Forms launched from links or buttons on your organization's website

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.

Note: Apple doesn't Apple Pay onboarding for test environments that aren’t publicly accessible or require authentication.

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. 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.

    Note: When you enter a domain, don't include http:// or https://.

  4. Select Save and verify.

  5. Repeat for each domain and subdomain where Apple Pay should appear. For example, you should separately enter myorganization.org, www.myorganization.org, and donate.myorganization.org.

    Note: Because "www" is considered a subdomain, you must verify it separately.

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