Skip to main content

Apple Pay

Using Apple Pay with payment form components.

Configuration​

To allow your customers to pay with Apple Pay™, you must first request that our Support team enables Apple Pay on your Account.

Domain Verification​

In addition to enabling Apple Pay on your Account, Apple requires you to register the domain you plan to use with Apple Pay.

To do so, you must host a specific domain association file on your domain, which Apple will periodically check for.

Download this domain association file and publish it to the domain on which you will be hosting your payment form, ensuring it is accessible to the public from the URL https://[DOMAIN_NAME]/.well-known/apple-developer-merchantid-domain-association. For example, if you will be hosting your payment page on your.domain.com, then the domain association file should be accessible at https://your.domain.com/.well-known/apple-developer-merchantid-domain-association

Once you have verified that the file is accessible at that URL, you are ready to request verification by Apple. Using your Application Token, submit a request to our API to register your domain. Let's assume your domain is your.domain.com, then the request would look like this:

POST /account/your-account-id/apple-pay
{
  domains: ["your.domain.com"]
}

When you submit the request, we will submit your domain to Apple for registration and they will attempt to download the domain association file.

You can register multiple domains, but each domain must serve the aforementioned domain association file.

Adding Wallets to your Form​

Once you have verified your domain and we have enabled Apple Pay for you, we can build on the example previously discussed on ExactJS Payment Forms. You can enable wallets by passing wallets: true as part of the options when adding the card component to your page.

Enabling Wallets
const components = exact.components({ orderId: "the_order_id" });
components.addCard('cardElement', { wallets: true });

If your Account is enabled for Apple Pay and Apple Pay is supported by the browser, the Apple Pay button will appear as part of the component, above the card details entry.

exactjs-apple-pay

If your customer chooses to pay with Apple Pay, they are prompted to choose their payment details from their Apple wallet and we will then use those details to pay for your order.

As usual, you will receive the paymentId in return if the payment was successful.

Note​

We do not support tokenization with Apple Pay, so even if you have set up your payment form to tokenize your customer's card details, if the customer chooses to use Apple Pay we will still only use their details to pay for the order. We do not tokenize the customer's Apple Pay details.

Finally, we recommend that you read the Apple Pay terms and conditions. These terms and conditions apply whenever the Apple Pay service is offered.