Apple Pay for Payment Pages


Apple Pay is a wallet-based mobile payment service by Apple Inc. that lets users process payments using an iPhone, iPad or Mac. Customers benefit from a familiar and streamlined checkout experience, where their billing information can be pre-filled, ready for purchase. Customers are authenticated quickly by placing their finger on the built-in reader or through facial-recognition. Apple Pay uses tokens to ensure no sensitive payment information is stored with Apple, on the customer’s device or on your own servers.



How it works

  • If supported by the customer’s device, Apple Pay will be displayed as an option to complete the payment.
  • The customer taps the Apple Pay button:
    • If the customer has previously set up Apple Pay, the payment sheet will slide into view, displaying the order details.
    • Customise the layout of Payment Pages
    • Otherwise, they will be prompted to set up their Apple Pay account prior to continuing with the payment process.
  • The customer can review the order and update their address and payment details, if needed.
  • The customer places their finger on the built-in reader or enables facial-recognition on their device in order to verify their identity and confirm the payment.
  • If successful, on-screen confirmation will be displayed and the customer will be redirected to our hosted response page.



  • Supported currencies: Dependent on your acquiring bank.
  • You can process Account checks with Apple Pay transactions, providing your acquiring bank supports this functionality. Contact our Support Team to enable account checks on your account. Account checks will be processed automatically prior to every payment, with no changes required to your checkout.
  • AVS (Address Verification Service) checks will be processed if supported by your bank, but security code checks are not possible with Apple Pay. This is because the security code cannot be stored on the customer’s phone or with Apple, and therefore cannot be sent on to the bank during the authorisation process for checks to be performed. As such, the response for the security code checks will always be “0”, indicating the security code was not sent.

    The security code setting on your security policy is not applicable for Apple Pay transactions, and therefore, they cannot be suspended based on the security code. However, AVS checks are still performed, and transactions can still be suspended due to your security policy configuration.

  • Protect Plus is supported, but checks cannot be run over the card details, as these are not made available to Trust Payments for Apple Pay transactions.
  • Payments may be subject to chargebacks, depending on your acquiring bank.





Enabling Apple Pay

To enable Apple Pay on your test site reference, please contact our Support Team. Once enabled, the Apple Pay button will be displayed on the payment choice and payment details pages (providing the browser supports the service) and you can test your solution.


Modify your POST to Trust Payments

You can optionally modify your POST submitted to Trust Payments to determine the billing and delivery address to be used for the payment authorisation. By submitting the following fields with value 1, this will ensure that the billing and delivery information are retrieved from the customer’s wallet. This expedites the payment process, providing a more seamless checkout experience for the customer.

  Field name Format Description
X3-EN.png billingcontactdetailsoverride Numeric (1)
  • "0" – Uses billing details submitted in the POST.
  • "1" – Uses billing details from the customer’s wallet.
X3-EN.png customercontactdetailsoverride Numeric (1)
  • "0" – Uses delivery details submitted in the POST.
  • "1" – Uses delivery details from the customer’s wallet.
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="billingcontactdetailsoverride" value="1">
<input type="hidden" name="customercontactdetailsoverride" value="1">
<input type="submit" value="Pay">

Replace <DOMAIN> with a supported domain. Click here for a full list.


Payment sheet

Prior to completing the purchase, the payment sheet is displayed to the customer. This presents the customer with cards previously-saved on their account, options for delivery, contact information and the full purchase amount (including tax and fees). They can review the order and optionally make adjustments before proceeding.



The customer will be able to select from the cards saved in their Apple Wallet.
The cards supported for payment are dependent on payment methods enabled on your Trust Payments account.

Information on the Apple Wallet: (link to external site)

When selecting their preferred card for the transaction, only cards supported by your site configuration are displayed to the customer on the payment sheet.


The addresses in the payment sheet will be populated by information stored on the customer’s Apple Pay account. If the customer has multiple addresses stored, they will be able to choose between them.


Label and amount

The mainamount value is displayed on the payment sheet, alongside the label, which shows the name of your company / business provided to our Support team when you first signed up with us.


The mainamount value is displayed on the payment sheet, alongside the label, which shows the name of your company / business provided to our Support team when you first signed up with us.

Information on Apple Pay authentication: (link to external site)



Your test site reference will connect to the Apple Pay testing sandbox. Therefore, in order to process payments on your test site reference, you will need to add test card details to the Apple Wallet on your supported device(s).

  You will be required to use the test card details provided by Apple. Please refer to this URL: (link to external site)

  Please be aware that the test card details we provide in our testing documentation cannot be used when processing Apple Pay test transactions.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request