Create Tenant

Create a new tenant for the merchant account. Requires JWT authentication.

Request

POST /merchant/tenant

Headers

Key	Value	Description
Authorization	Bearer YOUR_JWT_TOKEN	JWT access token
Content-Type	application/json	Request content type

Request Body

{
  "name": "Tenant Name",
  "domain": "tenant-domain",
  "description": "Tenant description",
  "settings": {
    "timezone": "UTC",
    "currency": "USD"
  }
}

Responses

200 OK

{
  "status": true,
  "data": {
    "id": "tenant_id",
    "name": "Tenant Name",
    "domain": "tenant-domain",
    "description": "Tenant description",
    "merchant_id": "merchant_id",
    "created_at": "2024-01-01T00:00:00Z"
  },
  "error": [],
  "message": "success!"
}

400 Bad Request

{
  "status": false,
  "data": {},
  "error": ["Domain already exists"],
  "message": "Tenant creation failed"
}

401 Unauthorized

{
  "status": false,
  "data": {},
  "error": ["Invalid or expired token"],
  "message": "Unauthorized"
}