Apple Pay (Hosted)

This guide assumes you have a Hosted Payment Page integration with Worldpay. If you do not, talk to your Worldpay Relationship Manager or Support Team before you proceed.


Before you begin, you must:

Full page redirect or iFrame/Lightbox redirect

If you use our full page redirect, the process is self serve. Go straight to theWorldpay MAI guidefor instructions on enabling Apple Pay on your Worldpay account.

For iFrame/Lightbox redirects, follow the steps in this guide before you complete the setup in the Worldpay MAI.

Full page redirect

You must request boarding to Apple Pay through the Worldpay MAI. Refer to theWorldpay MAI guidefor details.

Worldpay complete the boarding process with Apple on your behalf.

iFrame or Lightbox

For iFrame and Lightbox integrations you must:

  • Verify your domain with Apple Pay
  • Integrate with the Worldpay API
  • Configure your merchant account in the Worldpay MAI

Before you register your domains with Apple you must addthis fileto each domain. Put the file on your domain at this path: /.well-known/apple-developer-merchantid-domain-association.

To complete registration and the integration process, follow the instructions in theMAI guide.

Note: Domains are auto registered against all merchant codes.

Example XML request

Here's a basic example of the data submitted for a card test payment. Before you send it, change the merchantCode to your own, and be aware that each payment requires a unique orderCode:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE paymentService PUBLIC "-//Worldpay//DTD Worldpay PaymentService v1//EN" "">
<paymentService version="1.4" merchantCode="YOUR_MERCHANT_CODE"> <!--Enter your own merchant code-->
      <order orderCode="YOUR_ORDER_CODE" installationId="1234567"> <!--installationId identifies your Hosted Payment Page-->
         <description>YOUR_DESCRIPTION</description> <!--Enter a description useful to you-->
         <amount currencyCode="GBP" exponent="2" value="5000" />
            <include code="ALL" />
               <address2>Queensbridge Road</address2>
               <address2>Queensbridge Road</address2>


The response message is the same as ourstandard XML responses.

Payment page designer

Customise the look and feel of the Apple Pay button (text and scheme).


Worldpay’s test environment supports the use of Apple’s Sandbox Tester accounts and the sandbox test cards (Mastercard, Maestro, Visa, Amex and Discover) provided by Apple.

More details are at:

All Apple Pay transactions processed against the Worldpay test environment receive an AUTHORISED response status.

Some links to Apple Pay websites.

Apple Pay: Your Wallet. Without the wallet

Worldpay/Apple Pay

Developer: Apple Pay Resources

Developer: Apple Pay Developer Forums