Payment Domains

To display Apple Pay to payers, Apple requires verification of a website's domain. For certain Blackbaud solutions, if you host forms on your organization's domain, you can verify your domain with Apple directly from the Blackbaud Merchant Services Web Portal.

You only need to verify a domain once, regardless of how many Blackbaud Merchant Services accounts you have.

Tip: For assistance with these steps, reach out to your website administrator or similar resource.

From Control panel, Settings, expand Payment domains.

Add and verify your domain through the web portal for the following form types:

  • Luminate Online — Forms using new checkout in a custom secure domain

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

    Note: Standard Donation Forms follow a different verification process. For more information, see Apple Pay Setup in Online Giving Help.

Tip: Forms hosted by Blackbaud or launched from Blackbaud-hosted URLs are already verified with Apple.

To learn about Apple Pay setup in other solutions, see Digital Wallets.

  1. Download and unzip 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 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

    For assistance, reach out to your website administrator or similar resource.

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

  4. Select Add domain.

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

  6. Select Save and verify.

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

If a website domain is unverified, forms won't display Apple Pay. To verify a domain with Apple:

  1. Download and unzip 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 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

    For assistance, reach out to your website administrator or similar resource.

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

  4. Select the domain's menu .

  5. Select Verify and complete verification.

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