---
title: "Using Apple Pay (Hosted Page/Fields)"
description: "Accept Apple Pay payments on your store using KOMOJU Hosted Page or Hosted Fields, including domain registration instructions."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/apple-pay/using-apple-pay"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/apple-pay/using-apple-pay.md"
language: en
last_modified: "2025-12-18"
---

# Introduction

Apple Pay is a safe, reliable, and high success rate payment method that is extremely popular in Japan and abroad. Additionally, it can be quite simple to implement via KOMOJU. At this stage, KOMOJU only supports Apple Pay via Visa and Mastercard branded cards registered in the end user's Apple Wallet. Only JPY payments are supported.

To find out whether you are eligible to use Apple Pay via KOMOJU, please refer to [this page](https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/apple-pay/eligibility-criteria.md).

# Hosted Page

Once onboarded to Apple Pay, if you use the KOMOJU Hosted Page, you can simply add the `apple_pay` payment type to your session creation `payment_types`. **This is all that is needed!**

This will allow the end user to pick Apple Pay from the list of possible payment methods.

![Apple Pay option in Hosted Page payment list](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_1.png)

If you create a session with only Apple Pay as a payment method, the user will immediately get the familiar, Apple-branded "Pay with Apple Pay" button.

![Pay with Apple Pay button](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_2.png)

We also have special handling should you create a session with just Apple Pay and Credit Card, where the end user is given the choice on a single page, rather than via an upstream payment selection dialogue. This can be very powerful and increase payment success rate.

![Apple Pay and Credit Card on single page](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_3.png)

# Hosted Fields

To use Apple Pay with Hosted Fields, you will need to create a session in the same way as described in the above "Hosted Page" section. Additionally, because you will be hosting the fields within a page that is in your own domain, you need to register your domain with Apple. We have provided an easy interface to do so.

1. Download the [Apple Domain Association file](https://komoju.com/apple-pay/komoju-apple-pay-domain-verification.zip)
2. Place the file at the following path, within your domain and any other subdomains you may place hosted fields under:

`/.well-known/apple-developer-merchantid-domain-association`
3. The file must have Content-Type: text/plain in the header, be externally accessible, not be password protected, not be behind a proxy or redirect. Example of a file hosted correctly: [https://komoju.com/.well-known/apple-developer-merchantid-domain-association](https://komoju.com/.well-known/apple-developer-merchantid-domain-association)
4. Log into your KOMOJU Dashboard, and navigate to "Settings" on the left-hand bar. Then scroll down to "External Connections" and click on "Get Started" next to "Setup Apple Pay for API"

![Setup Apple Pay for API in Settings](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_4.png)
5. In the following page, click on "Register New Domain"

![Register New Domain button](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_5.png)
6. Input your full domain or subdomain name and click register

![Enter domain name and click register](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_6.png)
7. The domain appears in the list as registered

![Registered domains list](https://docs.priv.staging.komoju-dev.tools/apple-pay_using-apple-pay_7.png)
8. Repeat steps 2-7 for each domain or subdomain you will be using Apple Pay from

Once the above is done, you will be able to accept Apple Pay payments via Hosted Fields. Simply use the `apple_pay` slug when creating the Session for your Hosted Fields.