Create a merchant

Merchant Vouchers

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`

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"
    }
  ]
}