API Reference

Merchants

Merchant profile endpoints

Manage merchant profiles.

List Merchants

GET /api/public/v1/merchants

Parameter	Type	Description
page	number	Page number (default: 1)
limit	number	Items per page (max: 100)
search	string	Search by name
is_active	boolean	Filter by active status
business_state	string	Filter by state

Required Scope: merchants:read

Get Merchant

GET /api/public/v1/merchants/:id

Required Scope: merchants:read

Create Merchant

POST /api/public/v1/merchants

Required Scope: merchants:write

{
  "legalName": "New Business LLC",
  "dbaName": "New Biz",
  "businessState": "CA",
  "industry": "Retail",
  "ownerName": "Jane Doe",
  "ownerEmail": "jane@example.com"
}

Update Merchant

PATCH /api/public/v1/merchants/:id

Required Scope: merchants:write