# Create merchant

Endpoint: POST /v1/merchants
Version: 2.0.0
Security: oAuth2

## Header parameters:

  - `Idempotency-Key` (string)
    A unique key to make POST requests idempotent.

## Request fields (application/json):

  - `name` (string, required)
    Example: "Coffee Shop"

  - `country` (string, required)
    Example: "GT"

  - `mcc` (string, required)
    Merchant Category Code
    Example: "5812"

  - `address` (object)

  - `address.line1` (string)

  - `address.city` (string)

  - `address.state` (string)

  - `address.postalCode` (string)

  - `metadata` (object)

## Response 201 fields (application/json):

  - `merchantId` (string, required)
    Example: "mrc_01JH..."

  - `name` (string, required)

  - `country` (string, required)

  - `mcc` (string, required)

  - `status` (string, required)
    Enum: "active", "suspended", "pending_review"

  - `address` (object)

  - `address.line1` (string)

  - `address.city` (string)

  - `address.state` (string)

  - `address.postalCode` (string)

  - `createdAt` (string, required)

## Response 400 fields (application/json):

  - `traceId` (string, required)
    Correlation id for troubleshooting
    Example: "trc_01JH8K5P3V9M2K5Q7W6J3Z1A9B"

  - `error` (object, required)

  - `error.code` (string)
    Example: "INVALID_REQUEST"

  - `error.message` (string)
    Example: "Invalid merchant ID"

  - `error.details` (object)


## Response 401 fields