PUT /merchants/{id}

Update a merchant

Merchants

Description

Update an existing merchant business.

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

Users can only update their own merchant businesses.

Parameters

id integer path required
Merchant ID

Request Body

required

application/json

namestring
Merchant name
Example: TechStore Inc.
activity_typesarray [string]
List of activity types
Example: ["Shopping \u003e Computers"]
activity_introductionstring
Introduction text describing the merchant's activity
Example: We sell the latest tech products.
payment_methodstring
Payment method for invoices
Example: bank_transfer
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

200 Merchant updated successfully
application/json
statusstring
Example: success
messagestring
Example: Merchant updated successfully
dataobject
401 Authentication required
application/json
Example:
{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}
404 Merchant not found
application/json
Example:
{
  "status": "error",
  "message": "Merchant not found"
}
422 Validation error
application/json
Example:
{
  "status": "error",
  "message": "Failed to update merchant",
  "errors": [
    {
      "path": "activity_types",
      "message": "Invalid > Type is not a valid activity type"
    }
  ]
}