---
title: "Register Domain"
method: POST
path: "/apple-pay/domains"
tags: ["Apple Pay Domain"]
---

# Register Domain

`POST /apple-pay/domains`

Registers a domain with Apple Pay.

This endpoint allows you to register your website domain with Apple Pay, which is required
before you can accept Apple Pay payments on your website. The domain must be accessible
via HTTPS and have a valid SSL certificate.

Before registering, you must download
this [domain association file](https://assets.monei.com/apple-pay/apple-developer-merchantid-domain-association/)
and host it at `/.well-known/apple-developer-merchantid-domain-association` on your site.

For example, if you're registering `example.com`, make that file available
at `https://example.com/.well-known/apple-developer-merchantid-domain-association`.

The file has no extension, which trips up some servers (notably IIS, and any
setup that strips or rejects extensionless static files). Make sure the URL
returns HTTP 200 with the file's raw contents — not a 404, redirect, or HTML
page. Serving it as `Content-Type: text/plain` is the safest choice; add an
explicit MIME mapping for the extensionless filename if your server needs one.

After registration, Apple will verify your domain. Once verified, you can display
Apple Pay buttons and process Apple Pay payments on your website.

## Request body

- RegisterApplePayDomainRequest
  - `domainName` string, required — The domain name to register for Apple Pay.

## Response `200`

A successful response

- object
  - `success` boolean

## Other responses

- `400` — The request is incorrect or could not be processed
- `401` — Unauthorized error. Please check your auth credentials
- `404` — The specified resource was not found
- `422` — The request was well-formed but could not be processed due to semantic errors
- `500` — Unexpected server error
- `503` — The service is temporarily unavailable

---

[API](https://skmtc.net/monei/apis/monei-api-v1.md) · [All operations](https://skmtc.net/monei/apis/monei-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monei/monei-api-v1/revisions/23554d4fb9e5/schema)