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
requiredapplication/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_transfercountriesarray [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/jsonstatusstring
Example:
successmessagestring
Example:
Merchant updated successfullydataobject
401
Authentication required
application/jsonExample:
{
"status": "error",
"message": "Not authenticated or insufficient permissions"
}
404
Merchant not found
application/jsonExample:
{
"status": "error",
"message": "Merchant not found"
}
422
Validation error
application/jsonExample:
{
"status": "error",
"message": "Failed to update merchant",
"errors": [
{
"path": "activity_types",
"message": "Invalid > Type is not a valid activity type"
}
]
}