Shop Management

Author: Josh S. Sakweli, Backend Lead Team
Last Updated: 2025-09-232026-05-19
Version: v1.v2.0

Base URL: https://api.nextgate.com/api/v1

Short Description: The Shop Management API provides comprehensive endpoints for creating, managing, and retrieving shop information withinon the NextGate platform. This API handlesCovers shop registration, updates, approvals, categorization,WABA (WhatsApp Business) integration, AI chatbot toggling, and includesconversation integrated rating and review data for enhanced shop profiles.history.

Hints:

• All shop operationsendpoints requireuse properthe authenticationprefix via Bearer tokenapi/v1/e-commerce/shops
• Shop creation requires validauthentication; categorypublic IDusers andcan owneronly authenticationread
• Pagination uses 1-based page numbering (page=1 for first page)
• Shop approval operations require SUPER_ADMINROLE_SUPER_ADMIN or STAFF_ADMIN rolesROLE_STAFF_ADMIN
• Featured shops are randomized on each request for better discovery
• Rating and review data is automatically included in shop responses (read-only — managed by separate review service)
• WABA = WhatsApp Business Account integration for the shop's AI-powered chatbot

Standard Response Format

All API responses follow a consistent structure using our Globe Response Builder pattern:

Success Response Structure

{
  "success": true,
  "httpStatus": "OK",
  "message": "Operation completed successfully",
  "action_time": "2025-09-23T10:2026-05-19T10:30:45",
  "data": { // Actual response data goes here
  }
}

Error Responseresponses Structure

the same envelope with {
  "success": false,false "httpStatus":and "BAD_REQUEST",
  "message": "Error description",
  "action_time": "2025-09-23T10:30:45",
  "data": "Errorset description"to // or detailedthe error object
}

Standard Response Fields

Endpoints

1. Create Shop

Purpose: Creates a new shop with all required information including owner details, category assignment, and location data

Endpoint: POST {base_url}/api/v1/e-commerce/shops

Access Level: 🔒 Protected (Requires Bearer Token Authentication)

Authentication: Bearer Token

Request Headers:

Request JSON Sample:

{
  "shopName": "Mama Lucy's Restaurant",
  "shopDescription": "Authentic Tanzanian cuisine served with love in the heart of Dar es Salaam",
  "tagline": "Taste of home",
  "logoUrl": "https://example.com/logo.jpg",
  "bannerUrl": "https://example.com/banner.jpg",
  "shopImages": [
    "https://example.com/shop1.jpg",
    "https://example.com/shop2.jpg"
  ],
  "categoryId": "550e8400-e29b-41d4-a716-446655440000",
  "shopType": "HYBRID",
  "phoneNumber": "+255123456789",
  "email": "info@mamalucy.co.tz",
  "websiteUrl": "https://mamalucy.co.tz",
  "socialMediaLinks": [
    "https://facebook.com/mamalucy",
    "https://instagram.com/mamalucy"
  ],
  "address": "Msimbazi Street, Block 45",
  "city": "Dar es Salaam",
  "region": "Dar es Salaam",
  "postalCode": "12345",
  "countryCode": "TZ",
  "latitude": -6.7924,
  "longitude": 39.2083,
  "locationNotes": "Near the main bus stop",
  "businessRegistrationNumber": "REG123456",
  "taxNumber": "TAX789012",
  "licenseNumber": "LIC345678",
  "promotionText": "Grand opening - 20% off all meals!"
}

Request Body Parameters:

SuccessRequest JSON Sample:

{
  "shopName": "Mama Lucy's Restaurant",
  "shopDescription": "Authentic Tanzanian cuisine in the heart of Dar es Salaam",
  "phoneNumber": "+255123456789",
  "city": "Dar es Salaam",
  "region": "Dar es Salaam",
  "logoUrl": "https://example.com/logo.jpg",
  "bannerUrl": "https://example.com/banner.jpg",
  "shopImages": ["https://example.com/shop1.jpg"],
  "email": "info@mamalucy.co.tz",
  "countryCode": "TZ",
  "streetAddress": "Msimbazi Street, Block 45",
  "landmark": "Near the main bus stop",
  "latitude": -6.7924,
  "longitude": 39.2083
}

Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shop created successfully",
  "action_time": "2025-09-23T10:2026-05-19T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Restaurant",
    "shopSlug": "mama-lucys-restaurant",
    "shopDescription": "Authentic Tanzanian cuisine served with love in the heart of Dar es Salaam",
    cuisine..."tagline": "Taste of home",
    "logoUrl": "https://example.com/logo.jpg",
    "bannerUrl": "https://example.com/banner.jpg",
    "shopImages": [
      "https://example.com/shop1.jpg",
      "https://example.com/shop2.jpg"
    ],
    "ownerId": "456e7890-e89b-12d3-a456-426614174001",
    "ownerName": "Lucy Mwalimu",
    "categoryId": "550e8400-e29b-41d4-a716-446655440000",
    "categoryName": "Restaurant & Food",
    "shopType": "HYBRID",
    "status": "PENDING",
    "phoneNumber": "+255123456789",
    "email": "info@mamalucy.co.tz",
    "websiteUrl": "https://mamalucy.co.tz",
    "socialMediaLinks": [
      "https://facebook.com/mamalucy",
      "https://instagram.com/mamalucy"
    ],
    "address"streetAddress": "Msimbazi Street, Block 45",
    "city": "Dar es Salaam",
    "region": "Dar es Salaam",
    "postalCode": "12345",
    "countryCode": "TZ",
    "latitude": -6.7924,
    "longitude": 39.2083,
    "locationNotes"landmark": "Near the main bus stop",
    "businessRegistrationNumber": "REG123456",
    "taxNumber": "TAX789012",
    "licenseNumber": "LIC345678",
    "establishedYear": null,
    "isVerified": false,
    "verificationBadge": null,
    "trustScore": 0.00,
    "lastSeenTime": null,
    "isFeatured": false,
    "featuredUntil": null,
    "promotionText": "Grand opening - 20% off all meals!",
    "isApproved": true,
    "createdAt": "2025-09-23T10:2026-05-19T10:30:45",
    "updatedAt": "2025-09-23T10:2026-05-19T10:30:45",
    "approvedAt": null,
    "averageRating": null,
    "totalRatings": 0,
    "totalActiveReviews": 0,
    "reviews": []
  }
}

SuccessError Response FieldsResponses:

2. Get All Shops (List)

Purpose: Retrieves all shops in the system without pagination

Endpoint: GET {base_url}/api/v1/e-commerce/shops/all

Access Level: 🌐 Public (No authentication required)

Authentication:Returns None

Successlist Responseof JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Allall shops retrievedwith successfully",summary "action_time": "2025-09-23T10:30:45",
  "data": [
    {
      "shopId": "123e4567-e89b-12d3-a456-426614174000",
      "shopName": "Mama Lucy's Restaurant",
      "shopSlug": "mama-lucys-restaurant",
      "averageRating": 4.5,
      "totalRatings": 25,
      "totalActiveReviews": 12,
      "topReviews": [
        {
          "reviewId": "rev-123",
          "userName": "John Doe",
          "reviewText": "Amazing foodinfo and greattop service!",5 "createdAt":reviews "2025-09-22T14:30:00"per }
      ]
    }
  ]
}

3. Get All Shops (Paginated)

Purpose: Retrieves all shops with pagination support for better performance

Endpoint: GET {base_url}/api/v1/e-commerce/shops/all-paged

Access Level: 🌐 Public (No authentication required)

Authentication: None

Query Parameters:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shops retrieved successfully",
  "action_time": "2025-09-23T10:2026-05-19T10:30:45",
  "data": {
    "shops": [ { "shopId":...ShopSummary fields..."123e4567-e89b-12d3-a456-426614174000",
        "shopName": "Mama Lucy's Restaurant",
        "averageRating": 4.5,
        "totalRatings": 25,
        "city": "Dar es Salaam",
        "region": "Dar es Salaam" } ],
    "currentPage": 1,
    "pageSize": 10,
    "totalElements": 150,
    "totalPages": 15,
    "hasNext": true,
    "hasPrevious": false,
    "isFirst": true,
    "isLast": false
  }
}

4. Update Shop

Purpose: Updates shop information (only shop owners can update their shops)

Endpoint: PUT {base_url}/api/v1/e-commerce/shops/{shopId}

Access Level: 🔒 Protected (Shop Owner Only)

Authentication: Bearer Tokenonly)

Path Parameters:

RequestAll Headers:

Request JSON Sample:

{
	"shopName": "Mama Juma's Kitchen - Tabora",
	"shopDescription": "Authentic Tanzanian cuisine with fresh ingredients and traditional recipes passed down through generations. We specialize in local dishes like ugali, nyama choma, and pilau.",
	"logoUrl": "https://example.com/images/mama-juma-logo.jpg",
	"categoryId": "fec6a097-612c-470c-af4f-4807e24bef9a",
	"phoneNumber": "+255712345678",
	"city": "Dar es Salaam",
	"region": "Dar es Salaam",
	"tagline": "Taste of Home",
	"shopImages": [
		"https://example.com/images/shop-front.jpg",
		"https://example.com/images/kitchen.jpg"
	],
	"bannerUrl": "https://example.com/images/banner.jpg",
	"shopType": "ONLINE",
	"email": "info@mamajuma.co.tz",
	"websiteUrl": "https://mamajuma.co.tz",
	"socialMediaLinks": [
		"https://facebook.com/mamajuma",
		"https://instagram.com/mamajuma"
	],
	"address": "123 Msimbazi Street, Kariakoo",
	"postalCode": "11101",
	"businessRegistrationNumber": "VRI19939",
	"taxNumber": "TAX9482",
	"countryCode": "TZ",
	"latitude": -6.8160,
	"longitude": 39.2803,
	"locationNotes": "Near Kariakoo Market, opposite the blue building",
	"promotionText": "Free delivery within 5km for orders above 20,000 TSH"
}

Request Body Parameters:updated:

SuccessResponse: ResponseFull JSONShopResponse Sample(same shape as Create response)

Error Responses:

{
  "success"400: true,Not "httpStatus"the shop owner, or shop is deleted

401: "OK",Authentication "message"required

404: "Shop updatednot successfully",found
"action_time": "2025-09-23T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Premium Restaurant",
    "shopSlug": "mama-lucys-premium-restaurant",
    "updatedAt": "2025-09-23T10:30:45"
  }
}

5. Get Shop by ID (Summary)

Purpose: Retrieves basic shop information by shop ID

Endpoint: GET {base_url}/api/v1/e-commerce/shops/{shopId}

Access Level: 🌐 Public (No authentication required)

Authentication:Returns None

Path— Parameters:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shop retrieved successfully",
  "action_time": "2025-09-23T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Restaurant",
    "shopSlug": "mama-lucys-restaurant",
    "shopDescription": "Authentic Tanzanian cuisine",
    "logoUrl": "https://example.com/logo.jpg",
    "averageRating": 4.5,
    "totalRatings": 25,
    "totalActiveReviews": 12,
    "city": "Dar es Salaam",
    "region": "Dar es Salaam",
    "isVerified": false,
    "trustScore": 8.5 }reviews }and 

6. Get Shop by ID (Detailed)

Purpose: Retrieves complete shop information including sensitive business details (owner/admin access only)

Endpoint: GET {base_url}/api/v1/e-commerce/shops/{shopId}/detailed

Access Level: 🔒 Protected (Shop Owner or Admin Only)Admin)

Authentication:Returns Bearerfull TokenShopResponse including all reviews and management fields.

Path Parameters:

Request Headers:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shop retrieved successfully",
  "action_time": "2025-09-23T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Restaurant",
    "businessRegistrationNumber": "REG123456",
    "taxNumber": "TAX789012",
    "licenseNumber": "LIC345678",
    "averageRating": 4.5,
    "totalRatings": 25,
    "reviews": [
      {
        "reviewId": "rev-123",
        "userName": "John Doe",
        "reviewText": "Amazing food!",
        "status": "ACTIVE",
        "createdAt": "2025-09-22T14:30:00"
      }
    ]
  }
}

7. Get My Shops

Purpose: Retrieves all shops owned by the authenticated user

Endpoint: GET {base_url}/api/v1/e-commerce/shops/my-shops

Access Level: 🔒 Protected (Authenticated User Only)

Authentication:Returns Bearerall Token

Requestowned Headers:

Success Response JSON Sample:list).

{
  "success": true,
  "httpStatus": "OK",
  "message": "My shops retrieved successfully",
  "action_time": "2025-09-23T10:30:45",
  "data": [
    {
      "shopId": "123e4567-e89b-12d3-a456-426614174000",
      "shopName": "Mama Lucy's Restaurant",
      "status": "ACTIVE",
      "isApproved": true,
      "averageRating": 4.5,
      "totalRatings": 25,
      "createdAt": "2025-09-20T10:30:45"
    }
  ]
}

8. Get My Shops (Paginated)

Purpose: Retrieves user's shops with pagination support

Endpoint: GET {base_url}/api/v1/e-commerce/shops/my-shops-paged

Access Level: 🔒 Protected (Authenticated User Only)

AuthenticationQuery Parameters:

9. Approve / Reject Shop

Endpoint: BearerPATCH Tokenapi/v1/e-commerce/shops/{shopId}/approve-shop

Access Level: 🔒 Protected (ROLE_SUPER_ADMIN or ROLE_STAFF_ADMIN)

Query Parameters:

Request Headers:

9. Approve Shop

Purpose: Approve or reject a shop (admin operation)

Endpoint: PATCH {base_url}/shops/{shopId}/approve-shop

Access Level: 🔒 Protected (Super Admin or Staff Admin Only)

Authentication: Bearer Token

Path Parameters:

Query Parameters:

Request Headers:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shop approval status changed successfully",
  "action_time": "2025-09-23T10:2026-05-19T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Restaurant",
    "isApproved": true,
    "approvedAt": "2025-09-23T10:2026-05-19T10:30:45"
  }
}

10. Get Featured Shops by Category

Purpose: Retrieves all shops in a specific category

Endpoint: GET {base_url}/api/v1/e-commerce/shops/category/{categoryId}featured

Access Level: 🌐 Public

Returns up to 20 randomly selected featured shops (NoShopSummaryListResponse authenticationlist).

11. Get Featured Shops (Paginated)

Endpoint: GET api/v1/e-commerce/shops/featured-paged

AuthenticationAccess Level: None🌐 Public

PathQuery Parameters:

12. Search Shops

Endpoint: GET api/v1/e-commerce/shops/search

Access Level: 🌐 Public

Query Parameters:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shops by category retrieved successfully",
  "action_time": "2025-09-23T10:2026-05-19T10:30:45",
  "data": [
    {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
      "shopName": "Mama Lucy's Restaurant",
      "categoryName": "Restaurant & Food",
      "averageRating": 4.5,
      "city": "Dar es Salaam"
    }
  ]
}

11. Get Shops by Category (Paginated)

Purpose: Retrieves shops in a category with pagination

Endpoint: GET {base_url}/shops/category/{categoryId}/paged

Access Level: 🌐 Public (No authentication required)

Authentication: None

Path Parameters:

Query Parameters:

12. Get Featured Shops

Purpose: Retrieves randomly selected featured shops (up to 20 shops)

Endpoint: GET {base_url}/shops/featured

Access Level: 🌐 Public (No authentication required)

Authentication: None

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Featured shops retrieved successfully",
  "action_time": "2025-09-23T10:30:45",
  "data"content": [ { "shopId":...ShopSearchResponse fields..."123e4567-e89b-12d3-a456-426614174000",
      "shopName": "Mama Lucy's Restaurant",
      "averageRating": 4.5,
      "totalRatings": 25,
      "city": "Dar es Salaam",
      "isVerified": true } ],
    "totalElements": 8,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10,
    "hasNext": false,
    "hasPrevious": false
  }
}

13. Get FeaturedShop ShopsSummary (Paginated)Stats

Purpose: Retrieves featured shops with pagination (randomized on each request)

Endpoint: GET {base_url}/shops/featured-paged

Access Level: 🌐 Public (No authentication required)

Authentication: None

Query Parameters:

14. Get Shop Summary Statistics

Purpose: Retrieves comprehensive statistics including ratings, reviews, and user activities for a shop

Endpoint: GET {base_url}/api/v1/e-commerce/shops/{shopId}/summary-stats

Access Level: 🌐 Public

Returns authenticationaggregated required)review and rating statistics for a shop, including per-user activity.

Authentication: None

Path Parameters:

Success Response JSON Sample:

{
  "success": true,
  "httpStatus": "OK",
  "message": "Shop summary stats retrieved successfully",
  "action_time": "2025-09-23T10:30:45",
  "data": {
    "shopId": "123e4567-e89b-12d3-a456-426614174000",
    "shopName": "Mama Lucy's Restaurant",
    "averageRating": 4.5,
    "totalRatings": 25,
    "ratingDistribution": { "1": 1, "2": 2, "3": 5, "4": 7, "5": 10 },
    "totalReviews": 15,
    "activeReviews": 12,
    "hiddenReviews": 2,
    "flaggedReviews": 1,
    "userActivities": [
      {
        "userId": "user-123",
        "userName": "John Doe",
        "reviewId"feedbackId": "rev-123",
        "reviewText": "Amazing food and service!",
        "reviewStatus": "ACTIVE",
        "reviewDate": "2025-09-22T14:30:00",
        "ratingId": "rat-123",
        "ratingValue": 5,
        "ratingDate"date": "2025-09-22T14:35:2026-05-19T14:30:00",
        "hasReview": true,
        "hasRating": true
      }
    ]
  }
}

14. WABA (WhatsApp Business) Integration

WABA allows shops to receive and respond to WhatsApp customer messages via an AI-powered chatbot. The flow is: shop registers a WABA → admin approves with Meta credentials → shop toggles AI on/off and monitors conversation history.

SuccessBase Responsepath Fieldsfor all WABA endpoints: api/v1/e-commerce/shops/{shopId}/waba

Shared Path Parameter:

14a. Register WABA

Purpose: Shop owner submits a WhatsApp number and display name to begin WABA registration.

Endpoint: POST api/v1/e-commerce/shops/{shopId}/waba/register

Access Level: 🔒 Protected (Shop Owner)

Request Body:

Standard Error Types and Responses

Application-Level Exceptions (400-499)

• 400 BAD_REQUEST: General invalid request data, random exceptions, or item already exists
• 401 UNAUTHORIZED: Authentication issues (empty, invalid, expired, or malformed tokens)
• 403 FORBIDDEN: Access denied, permission issues, verification failures, expired invitations
• 404 NOT_FOUND: Requested resource does not exist
• 422 UNPROCESSABLE_ENTITY: Validation errors with detailed field information
• 429 TOO_MANY_REQUESTS: Rate limit exceeded

Server-Level Exceptions (500+)

• 500 INTERNAL_SERVER_ERROR: Unexpected server errors

ErrorRequest ResponseJSON ExamplesSample:

{
  "phoneNumber": "+255712345678",
  "displayName": "Mama Lucy's Restaurant"
}

14b. Approve WABA

Purpose: Admin approves a pending WABA registration by supplying Meta WABA credentials.

Endpoint: PATCH api/v1/e-commerce/shops/{shopId}/waba/approve

Access Level: 🔒 Protected (ROLE_SUPER_ADMIN or ROLE_STAFF_ADMIN)

Request Body:

14c. Resubmit WABA

Purpose: Shop Alreadyowner Existsresubmits a rejected or pending WABA with corrected info.

Endpoint: PATCH api/v1/e-commerce/shops/{shopId}/waba/resubmit

Access Level: 🔒 Protected (400)Shop Owner)

Request Body:

14d. Admin Update WABA

Purpose: Admin updates Meta credentials on an existing WABA account.

Endpoint: PATCH api/v1/e-commerce/shops/{shopId}/waba/admin-update

Access Level: 🔒 Protected (ROLE_SUPER_ADMIN or ROLE_STAFF_ADMIN)

Same request body as Resubmit WABA.

14e. Update WABA Status

Purpose: Admin changes the status of a WABA account (e.g., suspend or reactivate).

Endpoint: PATCH api/v1/e-commerce/shops/{shopId}/waba/status

Access Level: 🔒 Protected (ROLE_SUPER_ADMIN or ROLE_STAFF_ADMIN)

Query Parameters:

14f. Toggle AI Chatbot

Purpose: Shop owner enables or disables the AI chatbot for their WABA.

Endpoint: PATCH api/v1/e-commerce/shops/{shopId}/waba/toggle-ai

Access Level: 🔒 Protected (Shop Owner)

Query Parameters:

Response JSON Sample:

{
  "success": false,
  "httpStatus": "BAD_REQUEST",true,
  "message": "ShopAI withenabled this name already exists",
  "action_time": "2025-09-23T10:30:45"successfully",
  "data": {
    "ShopshopId": with"...",
    this"aiEnabled": nametrue,
    already"updatedAt": exists""2026-05-19T11:00:00"
  }
}

14g. Get WABA Conversations

UnauthorizedPurpose: -Retrieves Tokenpaginated IssuesWhatsApp conversation sessions for the shop.

Endpoint: GET api/v1/e-commerce/shops/{shopId}/waba/conversations

Access Level: 🔒 Protected (401)Shop Owner or Admin)

Query Parameters:

Response JSON Sample:

{
  "success": false,
  "httpStatus": "UNAUTHORIZED",true,
  "message": "TokenConversations has expired",
  "action_time": "2025-09-23T10:30:45"retrieved",
  "data": {
    "Tokencontent": has[ expired"{ "...WabaSessionResponse fields..." } ],
    "currentPage": 1,
    "pageSize": 10,
    "totalElements": 42,
    "totalPages": 5,
    "hasNext": true,
    "hasPrevious": false
  }
}

14h. Get Session Messages

Purpose: Retrieves paginated messages within a specific conversation session.

Endpoint: GET api/v1/e-commerce/shops/{shopId}/waba/conversations/{sessionId}/messages

Access DeniedLevel: -🔒 Protected (Shop Owner or Admin)

Additional Path Parameter:

Query Parameters:

14i. Get Session Messages by Date Range

Purpose: Retrieves messages in a session filtered by date range.

Endpoint: GET api/v1/e-commerce/shops/{shopId}/waba/conversations/{sessionId}/messages/by-date

Access Level: 🔒 Protected (Shop Owner or Admin)

Additional Path Parameter:

Query Parameters:

Quick Reference

Enums

ShopStatus: PENDING, ACTIVE, SUSPENDED, CLOSED, UNDER_REVIEW

ShopType: PHYSICAL, ONLINE, HYBRID

VerificationBadge: BRONZE, SILVER, GOLD, PREMIUM

ShopWabaStatus: PENDING, ACTIVE, SUSPENDED, REJECTED

Error Response Codes

Shop Not Found (404):

{
  "success": false,
  "httpStatus": "NOT_FOUND",
  "message": "Shop

Category Not Found (404):

{
  "success": false,
  "httpStatus": "NOT_FOUND",
  "message": "Shop category not found",
  "action_time": "2025-09-23T10:30:45",
  "data": "Shop category not found"
}

User Not Authenticated (404):

{
  "success": false,
  "httpStatus": "NOT_FOUND",
  "message": "User not authenticated",
  "action_time": "2025-09-23T10:30:45",
  "data": "User not authenticated"
}

Validation Error (422):

{
  "success": false,
  "httpStatus": "UNPROCESSABLE_ENTITY",
  "message": "Validation failed",
  "action_time": "2025-09-23T10:30:45",
  "data": {
    "shopName": "Shop name must be between 2 and 100 characters",
    "phoneNumber": "Phone number must be between 10-15 digits and may start with +",
    "email": "Email must be valid"
  }
}

1. 

Authorization: Bearer your_jwt_token_herechats