Developer

POST /merchants

Create a merchant

Merchants

Description

Create a new merchant business.

Authentication Required: User must be authenticated and have the 'merchant' feature flag.

The merchant is created with a pending_validation status and bank_transfer payment method by default.

Request Body

required

`application/json`

namestringrequired

Merchant name

Example: TechStore Inc.

activity_typesarray [string]required

List of activity types (required)

Example: ["Shopping \u003e Computers"]

activity_introductionstring

Introduction text describing the merchant's activity

Example: We sell the latest tech products.

countriesarray [string]

Countries where merchant operates (ISO 3166-1 alpha-2 codes)

Example: ["US","FR"]

invoice_address_first_namestring

First name for invoice address

invoice_address_last_namestring

Last name for invoice address

invoice_address_line_primarystring

Primary address line

invoice_address_line_secondarystring

Secondary address line

invoice_address_citystring

City

invoice_address_statestring

State or province

invoice_address_postal_codestring

Postal or ZIP code

invoice_address_countrystring

Country name (ISO 3166 short name)

invoice_address_company_namestring

Company name for invoice address

Responses

201 Merchant created successfully

application/json

statusstring

Example: success

messagestring

Example: Merchant created successfully

dataobject

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

403 Insufficient permissions

application/json

Example:

{
  "status": "error",
  "message": "Feature merchant required"
}

422 Validation error

application/json

Example:

{
  "status": "error",
  "message": "Failed to create merchant",
  "errors": [
    {
      "path": "activity_types",
      "message": "Activity types can't be blank"
    }
  ]
}