Skip to main content
Version: 1.0.0

Seller Profile & Location Management

Overview

The Seller Profile & Location Management APIs allow third-party sellers to onboard onto the FCC Marketplace, manage their business identity, and configure the physical locations used for order pickup and invoice generation.

A Seller represents a business entity that lists and fulfills products on the marketplace. Before a Seller can create SKUs or receive orders, their profile must exist and be in ACTIVE status.

Locations are physical locations associated with a Seller. There are two location types:

  • PICKUP — the location from which orders are dispatched to customers.
  • INVOICE — the registered business location used for tax and invoicing purposes.

A Seller must have at least one PICKUP location before any SKU can go live.

Typical onboarding flow

  1. Register via the Seller Portal to obtain app_id and app_secret.
  2. Generate a Bearer token via the OAuth endpoint.
  3. POST /v1/sellers — create your Seller profile.
  4. POST /v1/sellers/{sellerId}/locations — add at least one PICKUP location.
  5. Proceed to Listing Management APIs to create SKUs.

Authentication

Bearer token obtained from the OAuth endpoint: GET /api/oauth-service/oauth/token?grant_type=client_credentials&scope=seller_api using HTTP Basic Auth with your app_id and app_secret.

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT

Contact

FCC Marketplace Platform Team: fcc-platform@flipkart.com