---
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`

## Request

- Base URL: `https://api.sandbox.rainforestpay.com`
- URL: `https://api.sandbox.rainforestpay.com/v1/payment_method_domains`
- Auth: HTTP bearer

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/payments.md) - [All operations](https://skmtc.dev/rainforestpay/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/rainforestpay/apis/payments/revisions/9d7d0b1553a8?raw)