Skip to content

Last updated: 14 June 2025 | Change log

Mobile wallets

Take payments using Apple Pay and Google Pay on our Hosted Payment Pages.

Apple Pay

Prerequisite

Where integrating into an iframe, you must add a domain file to your website prior to attempting Apple registration. See Integrating into an iframe for more details.
After this, you must register the domain with Apple.

Worldpay eCommerce - Follow our instructions on how to enable Apple Pay in your dashboard.
Enterprise - Contact your Worldpay Implementation Manager to enable Apple Pay.

Supported devices

See the list of supported Apple devices.

Unsupported Merchant Category Codes (MCCs)

If your business trades under any of the following MCCs, you cannot accept Apple Pay payments:

  • 5912
  • 5967
  • 5993
  • 5999

For further insight please see the Apple Pay prohibited product list.

Integrating into an iframe

  1. Add this file to all your domains that host the Hosted Payment Pages iframe.
  2. Put the file on your domain at this path: /.well-known/apple-developer-merchantid-domain-association

The domains must have HTTPS, and also must not be behind a proxy or redirect.

Troubleshooting Apple registration failures

Although Apple, not Worldpay, verifies the domain, the following steps may help if your domain is rejected.

  1. Check that the website is fully accessible over HTTPS, and no 301 redirection is in use.
  2. Confirm that the file is available from the browser at [your domain]/.well-known/apple-developer-merchantid-domain-association.
  3. Do a difference check between the file on your site and this file. Sometimes, a single digit is dropped, resulting in failures.
  4. Include www in the domain request, for example www.worldpay-bsh.securedataplatform.com.

See also Apple Registration Help.

Customize Apple Pay

Enterprise
Customization is currently only available through a direct API call on a per transaction basis.

To tailor your payment pages through an API call use our API reference to:


SMB (Worldpay eCommerce)

You can customize your payment pages either through a direct API call on a per transaction basis or our Hosted Payment Page Designer which applies the settings to all requests.

Testing Apple Pay

Use Apple Pay's sandbox environment to test your API integration with the sandbox tester account and test cards (Visa, Mastercard and Amex) provided by Apple.


Google Pay

Prerequisite

Worldpay eCommerce - Follow our instructions on how to enable Google Pay in your dashboard.
Enterprise - Contact your Worldpay Implementation Manager to enable Google Pay.

Supported devices

See the list of supported Android devices.

Customize Google Pay

Enterprise
Customization is available through a direct API call on a per transaction basis only currently.

To tailor your payment pages through an API call use our API reference to:


SMB (Worldpay eCommerce)

You can customize your payment pages either through a direct API call on a per transaction basis or our Hosted Payment Page Designer which applies the settings to all requests.

Testing Google Pay

Use Google Pay's test card suite to test your API integration without adding a real card to your Google account.