Accept Apple Pay on a Hosted Payment Page

You can accept Apple Pay on a payment page by enabling the payment method. You can also customize the Apple Pay button style, color, and language as needed.

​

Considerations

Before you get started, keep these considerations in mind:

• You must have the Apple Pay service activated and payment method domains configured for your paypoint. See Apple Pay Overview for guidance.
• Apple Pay is available only for one-time payments. If autopay is enabled on a payment page, Apple Pay won’t be available as a payment method.
• For performance reasons, we don’t recommend embedding payment pages in iframes. However, when Apple Pay is enabled, a payment page embedded in an iframe won’t load at all.

​

Add Apple Pay to the payment page

To add Apple Pay acceptance on a payment page, you must first enable it as a payment method. Set applePay to true when creating or updating the payment page.

  "pageContent": {
    "paymentMethods": {
      "methods": {
        "applePay": true,
        "amex": true,
        "discover": true,
        "mastercard": true,
        "visa": true
      }
    }
  }

​

Configure the Apple Pay button

If you wish to customize the Apple Pay button on the payment page, you can pass configuration options using the paymentMethods.settings.applepay object.

For example, in your request to the create a payment page endpoint, you could change the button’s style, color and language:

"paymentMethods":{
  ...
  "settings":{
    "applepay":{
      "buttonType":"support",
      "buttonStyle":"white-outline",
      "language":"ca-ES"
    }
  }
}

​

Prefill fields with Apple Pay

Prefilling payment fields is covered in the Hosted Payment Pages Quickstart.