---
title: "Register a domain for Apple Pay"
method: POST
path: "/apple-pay/web-domains"
tags: ["Apple Pay"]
---

# Register a domain for Apple Pay

`POST /apple-pay/web-domains`

Registers a domain name for Apple Pay on the web. Note that this is required if relying on Ryft's Apple Pay processing certificate.

A **Maxiumum** of 99 domains can be registered against a single Ryft account.

Each domain must host our verification file under `/.well-known/apple-developer-merchantid-domain-association`.

**Important:** the `Content-Type` of the hosted file must be `application/octet-stream`.

## Headers

- `Account` string

## Request body

- object — The request body for registering a web domain for Apple Pay
  - `domainName` string, required — The domain name you want to register for Apple Pay.

## Response `200`

Apple Pay web domain successfully created

- ApplePayWebDomain
  - `id` string — The unique ID for the web domain
  - `domainName` string — The domain name registered for Apple Pay
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the apple pay web domain was created

## Other responses

- `400` — One or more inputs are invalid
- `500` — An unexpected error occurred when executing this request

---

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