> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattildapayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Pay on web with Embed

Apple Pay is the faster, more secure way to pay online using cards saved
on your customer's Apple device.

We support Apple Pay out of the box in Embed with minimal configuration.

## About this integration

Embed requires minimal configuration to get set up to process Apple Pay. Unlike
some other integrations it does not require you to sign up for an Apple Pay Developer account.

* Upload our **Domain Association File** to your website.
* Enable Apple Pay in your merchant dashboard.

## Enable Apple Pay

To enable Apple Pay, head over to your dashboard and then go to
**Connections** -> **Catalog** -> **Apple Pay**.

Next, complete and submit the form to create a new Apple Pay service.

### Registering a domain

To process Apple Pay via the web you will need to register all the domains where the buyer can
checkout. In order to do this, navigate to your Apple Pay service via the dashboard, **Connections** -> **Apple Pay** -> **Domains** -> **Add domain name**.

<Warning>
  **Domain Association File**

  Before submitting a domain name, please download the Domain Association File from
  the dashboard and upload it to every domain you wish to support.

  The file needs to be added to every domain in a predefined location.

  ```
  https://{domain}/.well-known/apple-developer-merchantid-domain-association
  ```

  This file is checked by Apple in the production environment
  to verify that you have granted us permission to perform
  Apple Pay transactions on your dashboard.
</Warning>

<Snippet file="apple-pay/testing.mdx" />

<Frame>
  <img src="https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/images/apple-pay/add-card-mac.png?fit=max&auto=format&n=NYRslQ0epuL-JaEH&q=85&s=895a620df268c401898b3acb3b6ac1b1" alt="Apple Pay - Add card" width="669" height="366" data-path="assets/images/apple-pay/add-card-mac.png" />
</Frame>

### Create sandbox transaction

To make an Apple Pay sandbox transaction the following are required.

* An Apple Pay compatible device with a Sandbox Tester account on it
* One or more test cards added to the Sandbox Tester account on that device
* Embed loaded on an HTTPS site in an Apple Pay compatible browser
* Apple Pay enabled in the dashboard
* A card processor enabled that can process Apple Pay in the given currency.

For a currency that has a card processor that supports Apple Pay, you
should see the payment option in your app. Select Apple Pay and continue
with the payment. You should see the Apple Pay sheet appear.

<Frame>
  <img src="https://mintcdn.com/mattilda/NYRslQ0epuL-JaEH/assets/images/apple-pay/web-confirm.png?fit=max&auto=format&n=NYRslQ0epuL-JaEH&q=85&s=2d59f30d467a50bc7ac2cfa38216c5b8" alt="Apple Pay - Add card" width="880" height="806" data-path="assets/images/apple-pay/web-confirm.png" />
</Frame>

### Create production transaction

To make an Apple Pay transaction in production replace the Sandbox Tester account
with a regular Apple account with real cards.

<Snippet file="apple-pay/third-party-browsers-support.mdx" />

<Snippet file="apple-pay/common-issues-web.mdx" />