Documentation

Vendor Guide

For sellers. Everything happens in the vendor dashboard at /vendor, available after the marketplace administrator approves your account.

On this page

Registration & approval

  1. Register a normal customer account at /register.
  2. Apply to become a vendor (from the account menu or the “Become a seller” link the marketplace provides).
  3. Fill store name, description, and any details the administrator requires.
  4. Wait for approval — the admin reviews applications in Admin → Vendors.

✓ Success: you receive access to /vendor. Until then, the vendor dashboard is not available.

Approval is always manual or per the administrator's policy — there is no automatic vendor signup bypass.

Store setup

Product management

  1. Vendor → Products → create. Fields mirror the admin product form (title, price, images, variants, category).
  2. New products enter the review state if the admin enabled manual approval; otherwise they publish immediately.
  3. Edit any time — changes are versioned by updated-at and reflected on the storefront after publish.
  4. Duplicate or archive products you no longer sell (archiving keeps order history intact).

✓ Success: your product page renders at /products/your-product with your store linked.

Inventory

Orders & shipments

  1. Vendor → Orders: only orders containing your items appear — customer contact is limited to what fulfillment requires.
  2. Each order shows your sub-order: items, the customer's chosen shipping method, and the shipping charge snapshot.
  3. Accept and prepare the order, then advance the shipment status (processing → packed → shipped) adding a tracking number and carrier if you have one.
  4. The customer sees status changes on their order page; notifications go out automatically (no duplicates on retries).
  5. Pickup orders (if the admin enabled pickup for your store): mark “ready for pickup”; completion records the timestamp.

✓ Success: order status updates reach the customer without admin involvement.

Shipping options

What you can configure depends on the policy the administrator set for your store (Admin → Shipping → Vendor policies):

CapabilityIf allowed by admin
Vendor-specific ratesCreate your own rates (e.g. item-based pricing) for your items — they take priority over the platform rate where configured
Method togglesEnable/disable specific shipping methods for your store
Handling timeSet your preparation days — reflected in delivery estimates
Origin addressSet your ship-from address used for zone matching
Pickup locationsCreate pickup points with address, hours, and instructions
Courier accountConnect an approved courier integration
Vendors can never change global methods/zones, other vendors' data, or set negative shipping charges — the server blocks it regardless of what the UI shows.

Earnings & payouts