**Last updated**: 14 June 2025 | [**Change log**](/products/hosted-payment-pages/changelog/)

# 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](#integrating-into-an-iframe) for more details. After this, you must register the domain with Apple.
**Worldpay eCommerce** - Follow our [instructions](https://worldpay.egain.cloud/kb/PHC/content/DEV-27875/What-are-my-Worldpay-eCommerce-Configuration-Settings-how-do-I-amend-them-in-Worldpay-Dashboard) on how to enable Apple Pay in your [dashboard](https://dashboard.worldpay.com/).
**Enterprise** - Contact your Worldpay Implementation Manager to enable Apple Pay.

### Supported devices

See the list of [supported Apple devices](https://support.apple.com/en-gb/HT208531).

### 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](https://developer.apple.com/apple-pay/acceptable-use-guidelines-for-websites/).

### Integrating into an iframe

1. Add [this file](https://payments.worldpay.com/.well-known/apple-developer-merchantid-domain-association) 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](https://payments.worldpay.com/.well-known/apple-developer-merchantid-domain-association). Sometimes, a single digit is dropped, resulting in failures.
4. Include www in the domain request, for example www.worldpay.com.


See also [Apple Registration Help](https://developer.apple.com/documentation/applepayontheweb/configuring-your-environment#Register-and-Verify-Your-Domain).

### 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:

* customize [the CSS](/products/hosted-payment-pages/openapi/other/create#other/create/t=request&path=hostedcustomization), e.g. color, buttons, background
* customize [functional properties](https://developer.worldpay.com/products/hosted-payment-pages/openapi/other/create#other/create/t=request&path=hostedproperties), e.g. change the text of your Apple Pay button


br
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](https://developer.apple.com/apple-pay/sandbox-testing/) 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](https://worldpay.egain.cloud/kb/PHC/content/DEV-27875/What-are-my-Worldpay-eCommerce-Configuration-Settings-how-do-I-amend-them-in-Worldpay-Dashboard) on how to enable Google Pay in your [dashboard](https://dashboard.worldpay.com/).
**Enterprise** - Contact your Worldpay Implementation Manager to enable Google Pay.

### Supported devices

See the list of [supported Android devices](https://developers.google.com/pay/issuers/overview/supported-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:

* customize [the CSS](/products/hosted-payment-pages/openapi/other/create#other/create/t=request&path=hostedcustomization), e.g. color, buttons, background
* customize [functional properties](https://developer.worldpay.com/products/hosted-payment-pages/openapi/other/create#other/create/t=request&path=hostedproperties), e.g. change the text of your Google Pay button


br
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](https://developers.google.com/pay/api/web/guides/resources/test-card-suite) to test your API integration without adding a real card to your Google account.