Apple Pay

Shoppers on your online store can use Apple Pay for a fast and convenient checkout experience. Apple Pay is not a standalone payment gateway module in Miva. Instead, it works alongside supported payment gateways to securely process transactions using the customer’s saved Apple payment methods.

You can add Apple Pay to your store using either Page Templates or the PageBuilder Apple Pay fragment, giving you flexibility in how and where the button appears.

On This Page

• Prerequisites
• How to Enable Apple Pay
• Adding Apple Pay to Page Templates
• Adding Apple Pay Using PageBuilder
• Apple Pay Button Options
• Enable Apple Pay on Your Payment Gateway
• Error Validation

Prerequisites

Before enabling Apple Pay, make sure your store meets the following requirements:

• Apple Pay in Miva currently works with the Authorize.Net and Braintree payment gateways.
• Your store pages must be served over HTTPS (secure connection).
• Apple Pay is available in Safari on supported macOS and iOS devices with Apple Pay enabled.How to Enable Apple Pay

Apple Pay Domain Requirements

Apple Pay must be registered and validated for each domain where it is used. Apple does not allow a single Apple Pay Merchant ID to be shared across multiple domains without proper registration.

In multi-domain environments, each domain must be individually registered for Apple Pay. Attempting to reuse the same configuration across domains may result in setup or checkout errors.

If you encounter domain registration issues or errors such as “domain already registered,” contact Miva Technical Assistance Center (TAC) for assistance.

Install the Apple Pay module:

1. In the Miva admin, click Settings in the lower-left corner.

2. Select Modules.

3. Use the Type dropdown filter and choose Payment to narrow the results, or enter Apple Pay in the search bar to quickly locate the module.

4. Locate Apple Pay and click Install.

After installation, a new tab appears under Payment Settings called Apple Pay Settings.

PATH: Settings > Payment Settings > Apple Pay Payment Settings.

Networks Section: Allows you to control how each supported card network is processed when a customer uses Apple Pay (American Express, Discover, MasterCard, and Visa). Networks are set to Automatic by default.

Each network can be set to:

• Automatic – Miva automatically routes Apple Pay transactions through the first installed gateway that supports that card network.

• Not Supported – Apple Pay transactions for that card network will not be accepted.

This flexibility is especially helpful if you have multiple supported gateways installed and want more control over how Apple Pay transactions are processed.

Currently, Authorize.Net and Braintree are the only gateways that support Apple Pay in Miva. At least one of these gateways must be installed and configured before Apple Pay can be enabled.

Add Apple Pay to a Product Page Using PageBuilder

Apple Pay can be added directly to the Product Display page using the built-in Product Display Flex component. 

Note: The Apple Pay button will only be visible to customers using Safari on supported macOS or iOS devices with Apple Pay enabled.

When using PageBuilder, the Apple Pay fragment can be included within the Product Display Flex component, allowing the Apple Pay button to appear on the product page without editing templates or creating a custom Flex component.

For Apple Pay to appear in the Product Display Flex component the store must be using the latest Shadows Framework of 10.13.04 or later. Once your Shadows Theme is updated a new Apple Pay Configuration is added to Theme Components > Content Section and a new Fragment is added to Fragments > Product Details Additional Data.

Adding Apple Pay to Page Templates

For best conversion results, Apple Pay is typically placed in the following locations:

• Product Page

• Basket Page

• Bill To / Ship To (OCST)

• Global Mini-Basket

To display the Apple Pay button on a page template, complete the following steps:

1. Assign the Apple Pay item to the page.

2. Add the Head Tag item.

3. Add the appropriate Button Tag item.

Template Items

Head Tag Item

<mvt:item name="applepay" param="head" />

Product Page Button Tag

<mvt:item name="applepay" param="product" />

Basket / Checkout Button Tag

<mvt:item name="applepay" />

Apple Pay Button Options

Apple Pay buttons include several configuration options that allow you to control how the button appears on your storefront.

Type

Choose the text displayed on the button:

• Plain

• Buy with Apple Pay

Style

Choose the visual appearance of the button:

• Black

• White

• White with Outline

Button Sizing Guidelines

Apple recommends that the Apple Pay button matches the size of other primary buttons on your site.

• The button may be equal to or larger than similar payment or checkout buttons.

• The button should not be smaller than other primary action buttons.

Keeping button sizing consistent helps maintain a polished look and ensures the Apple Pay option is clearly visible to shoppers.

Type Examples

Style Examples

Apple Pay — Black Button, White Button with Black Outline, White Button with no Outline

Enable Apple Pay on Your Payment Gateway

Before Apple Pay can be used in your store, it must also be enabled within your payment gateway.

Braintree

To enable Apple Pay in Braintree:

1. Log in to your Braintree account.

2. Go to Settings.

3. Select Processing.

4. Under Accept Apple Pay, click Enable.

You will also need to verify and register your domain with Apple within your Braintree account.

Refer to Braintree’s documentation for detailed domain verification steps.

Authorize.net

No additional settings are required within Authorize.Net to enable Apple Pay.

Authorize.Net supports Apple Pay when using the following merchant processors:

• Chase Paymentech

• Global Payments

• TSYS

• First Data (Nashville)

Make sure your Authorize.Net account is configured with one of the supported processors listed above.

Error Validation

Apple Pay supports address validation during checkout.

If required address fields are missing, the customer will be prompted to complete them before the order can be placed.

Miva uses the required field settings configured in your store to determine which address fields must be completed.