# Apple Pay configuration guide

> Instructions for configuring Apple Pay through APO Dashboard.

This guide provides step-by-step instructions for configuring Apple Pay through APO Dashboard. Before starting the configuration, identify your integration scenario to determine which dashboard sections you need to complete.

| **Integration scenario** | **Merchant ID** | **Processing entity** | [**Domain verification**](#KiOnu) | [**Payment certificate configuration**](#Drw9a) |
| --- | --- | --- | --- | --- |
| [Hosted CKP](https://docs.antom.com/ac/apo/HOSTEDCKP.md) | Antom | Antom | No | No |
| [Embedded CKP](https://docs.antom.com/ac/apo/embeddedckp.md) | Antom | Antom | Yes | No |
| [SDK](https://docs.antom.com/ac/apo/card_sdk.md) - Web | Antom | Antom | Yes | No |
| [SDK](https://docs.antom.com/ac/apo/card_sdk.md) - WAP/iOS/Android | Antom | Antom | No | No |
| [API](https://docs.antom.com/ac/apo/cardinfocallmerchant.md) | Merchant | Merchant | No | Yes |

## View the payment method page

1.  Log in to APO Dashboard and navigate to **Acquirer Management**.
2.  Select your **Connected Acquirer** from the list.
3.  Select the specific **Merchant account** and you will see the **Payment methods configuration** below.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/d9911313-ffac-4d74-ac5f-989a6ad89b34.png)

3.  Click the specific **Merchant account**, and under **Payment methods configuration**, find **APPLEPAY** and click **Configure** to view the payment method page. 

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/07a0ce78-79bb-40d1-b917-662e31b29801.png)

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/24d675d4-058a-448c-8c21-41d001ca27fd.png)

## Domain verification

If you are using your own domain to set up Apple Pay for your organization, you must first register the merchant domains that will process transactions to verify ownership of your website. Go to the **Domain Management** to add a new domain. Then, download the domain verification file and host it on your server at the specified path.

> **Note**: If your integration scenario is [Embedded Checkout Page](https://docs.antom.com/ac/apo/embeddedckp.md) or [SDK](https://docs.antom.com/ac/apo/card_sdk.md) (Web), domain verification is required.

1.  On the payment method page, click **Domain Management > Add new domain**.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/26bedc3d-a22c-4a03-bffe-73ee4e3171b9.png)

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/90e8bc8a-56bb-4452-8dd6-1d4eb4a0e8dc.png)

2.  On the **Domain configuration** pop-up window, specify the following:

1.  **Add domain**: Please provide the domain where you wish to enable Apple Pay.
2.  **Download domain verification file**: Download the domain association file provided by Antom
3.  **Upload domain verification file**: Host the downloaded file on your server at: [/.well-known/apple-developer-merchantid-domain-association.](/.well-known/apple-developer-merchantid-domain-association..md)
4.  Click **Continue** to complete the domain configuration.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/469152c0-fcd8-4681-a9cc-1ff4317d6947.png)

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/1fec9b17-e7f2-4bdf-af1f-5c75f849d24c.png)

> **Note**: If you require assistance, please contact us at [channelintegrationOps@alibaba-inc.com](channelintegrationOps@alibaba-inc.com) and include the system Trace ID to help us identify the issue.

## Payment certificate configuration

For API integration, create and register your payment certificate to encrypt sensitive information during Apple Pay transactions, and manage the CSR (Certificate Signing Request) and CER (Certificate) exchange.

1.  On the payment method page, click on the **Payment Certificate**.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/daae1615-41f1-432c-bca4-dcd167288472.png)

2.  Click **Dowload** to obtain the CSR file. This is required to enable Apple Pay for native iOS apps.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/55d5d221-ff61-407c-b26a-af1254420148.png)

3.  Click **Continue**, and follow the steps listed to complete the certification configuration in the [Apple Developer Center](https://developer.apple.com/account/resources/identifiers/list/merchant).

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/e39d0343-28cc-48be-8056-77ca6cd60a6e.png)

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/253bad46-18d5-41fa-b47a-65f73053b815.png)

4.  After completing the configuration in [Apple Developer Center](https://developer.apple.com/account/resources/identifiers/list/merchant), click **Continue**.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/64d27172-917c-4189-bfd5-141f7011ac38.png)

5.  Click **Upload certificate**. Upload the _.cer_ file that you downloaded from the Apple Developer Center and click **Complete**.

> **Note**: Ensure the certificate is valid and not expired.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/3b7ecd2b-f750-4029-bd2a-58d5714c5b45.png)

6.  Return to the [Apple Developer Center](https://developer.apple.com/account/resources/identifiers/list/merchant), select the Merchant ID and activate the Apple Pay Payment Processing Certificate you created.
7.  Integrate Apple Pay into your app.
8.  (Optional) If you need to renew the certificate, click **Renew** and upload the new certificate file.

![image.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2026/png/151b40fb-5f42-46d7-bb07-018c4efe54d4.png)