Configuring Apple Pay for Web

Hosted Payments solution allows you to securely accept payments using Apple Pay on your website for customers who use Apple's Safari browser for web payments.

The following sections help you integrate Apple Pay on your website using Hosted Payment Page.

Prerequisites

Before integrating Apple Pay on your website, ensure the following requirements are met:

• Apple Pay works on MacBook with macOS version 10.12.1 or later.

• Apple Pay works on iPhone with iOS version 10.1 or later.

• Apple Pay works on the Safari browser.

• Set your server to allow Apple Pay.

• Serve your application over HTTPS in both development and production environments.

• Your domain must have a valid SSL certificate.

• Your server must support the Transport Layer Security (TLS) protocol version 1.2 or later and one of the cipher suites.

Tip: To set up your production environment, see the Apple Server Configurations.

Supported Payment Methods

Apple Pay supports following cards for web payments:

Supported Cards

• Visa

• MasterCard

• American Express

• Discover

Apple Pay supports following merchant capabilities for web payments:

Merchant Capabilities

• Credit cards (Visa or Mastercard)

• Debit cards (Visa or Mastercard)

Unsupported Payment Methods

Apple Pay does not support following web payment methods:

• In-App Payments

• Recurring Payments

• Split Shipment

• Voids/Refunds through Apple Pay

Notes:

• Do not use Apple Pay tokens for ad hoc charges.

• Do not use Apple Pay for Web to create a Xplor Pay token. This may result in declining the transaction or failing to settle the transaction.

Integrating the Apple Pay Button

To integrate the Apple Pay button on your website:

• You must participate in Apple Pay Beta program (during Beta-phase only).

• You must use Direct-to-VISA (set allow Apple Pay for your Merchant Account).

• You must set the show-apple-pay property to true.

• You must have at least one registered domain. (For more information, see Registering Merchant Domain)

• You must set the Payment Method to Sales or Authorizations.

• The Apple Pay button appears only on the Safari browser.

Registering Merchant Domain

Note: You do not need to create an Apple Merchant ID or CSR for the Merchant Validation process. Xplor Pay manages the Merchant Validation process for you.

To register merchant domain:

1. Go to the Merchant Home.

2. Select VT Settings in the Virtual Terminal.

3. Select a terminal.

4. Select the Apple Pay for Web tab.

5. Register your domain.

Configuring Apple Pay for Web

• Set the show-apple-pay property to make the Apple Pay button visible on your website.

• The Apple Pay button appears with default style. You can select different types of button styles that fit with the terminology and flow of your purchase or payment experience on your website. For more information, see Apple styling guidelines.

Note: Hosted Payment Page supports Apple Pay JS Version 3, which limits you from selecting the different Apple Pay button styles. For more information, see Apple Pay Button CSS documentation.

• The #Clearent-apple-pay element or the .Clearent-apple-pay CSS class allows you to style the Apple Pay button on your website.

• The #Clearent-apple-pay-row element or the .Clearent-apple-pay-row CSS class allows you to style the Apple Pay row on your website.

• The #Clearent-apple-pay-label element or the .Clearent-apple-pay-label CSS class allows you to style the Apple Pay label on your website. The default label text is "Or pay another way".

Testing Apple Pay for Web

To test offline implementation of Apple Pay for your website, see Sandbox Testing.