---
title: "Create payment method domain"
method: POST
path: "/v1/payment_method_domains"
tags: ["Payment Method Domains"]
---

# Create payment method domain

`POST /v1/payment_method_domains`

Create payment method domain to verify your domain for payment processing with Apple Pay.

A platform can have up to 99 domains.

If your integration requires a domain per merchant, then register the domain by providing a merchant_id in the request. Each merchant can have up to 99 domains.

## Parameters

- `#/paths/~1v1~1payins/get/parameters/0` — unresolved $ref

## Request body

- Data — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` object — A payment method domain
    - `payment_method_domain_id` string — The unique payment method domain identifier. Prefix is "pmd" in production and "sbx_pmd" in sandbox.
    - `merchant_id` MerchantId — unresolved $ref
    - `domain_name` string — A fully qualified domain name
    - `status` 'CREATED' | 'VERIFIED' | 'DELETED' — The status of the payment method domain
    - `created_at` string, date-time — The datetime when the domain was created, in RFC3339 format.
    - `updated_at` CreatedAt — unresolved $ref
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)