Admin Approval

Admin endpoints for managing seller applications, verifying shops, and viewing all Sellers.

GET
/Sellers
Get All Sellers (Admin)
List all Sellers. Requires admin Authorization: Bearer <token>.

Query Parameters

Query Parameters
Query:
page: number (default: 1)
limit: number (default: 20)
status: Pending | Verified | Rejected
search: string

Response

Response (200 OK)
{
  "success": true,
  "data": {
    "Sellers": [
      {
        "referenceId": "ByF-INF-1BAF75",
        "shopName": "TechZone Ethiopia",
        "shopBio": "Your one-stop shop for smart gadgets and accessories.",
        "verificationStatus": "Verified",
        "tinNumber": "1001234567",
        "vatNumber": "ET1001234567890",
        "submittedAt": "2024-01-15T10:30:00Z",
        "verifiedAt": "2024-01-20T14:00:00Z"
      },
      {
        "referenceId": "ByF-INF-2ABC89",
        "shopName": "Fashion Hub",
        "shopBio": "Latest fashion trends and styles.",
        "verificationStatus": "Pending",
        "submittedAt": "2024-03-18T09:15:00Z"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 5,
      "totalItems": 98,
      "itemsPerPage": 20
    }
  }
}
GET
/Sellers/{referenceId}
Get seller Details (Admin)
Get details for a specific seller. Requires admin Authorization: Bearer <token>.

Query Parameters

Query Parameters
Path:
referenceId: string (e.g., "ByF-INF-1BAF75")

Response

Response (200 OK)
{
  "success": true,
  "data": {
    "referenceId": "ByF-INF-1BAF75",
    "shopName": "TechZone Ethiopia",
    "shopBio": "Your one-stop shop for smart gadgets and accessories in Addis Ababa.",
    "tinNumber": "1001234567",
    "vatNumber": "ET1001234567890",
    "verificationStatus": "Verified",
    "verificationNote": "All documents verified successfully.",
    "twitterAccount": "https://twitter.com/techzone_ethiopia",
    "facebookAccount": "https://www.facebook.com/techzoneethiopia",
    "instagramAccount": "https://www.instagram.com/techzone_ethiopia",
    "linkedinAccount": "https://www.linkedin.com/company/techzone-ethiopia",
    "youtubeAccount": "https://www.youtube.com/@techzoneethiopia",
    "tiktokAccount": "https://www.tiktok.com/@techzoneethiopia",
    "submittedAt": "2024-01-15T10:30:00Z",
    "verifiedAt": "2024-01-20T14:00:00Z",
    "verifiedBy": "admin@byfluence.com"
  }
}
PATCH
/Sellers/{referenceId}/verification
Verify/Approve seller
Approve or reject a seller application. Requires admin Authorization: Bearer <token>.

Query Parameters

Query Parameters
Path:
referenceId: string (e.g., "ByF-INF-1BAF75")

Status values:
Verified | Rejected | Pending

Request Body

Request
{
  "referenceId": "ByF-INF-1BAF75",
  "status": "Verified",
  "note": "All documents verified successfully. Shop meets all requirements for platform listing."
}

Response

Response (200 OK)
{
  "success": true,
  "message": "seller verification status updated successfully",
  "data": {
    "referenceId": "ByF-INF-1BAF75",
    "verificationStatus": "Verified",
    "verificationNote": "All documents verified successfully. Shop meets all requirements for platform listing.",
    "verifiedAt": "2024-03-20T15:30:00Z",
    "verifiedBy": "admin@byfluence.com"
  }
}