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
- Register a normal customer account at
/register. - Apply to become a vendor (from the account menu or the “Become a seller” link the marketplace provides).
- Fill store name, description, and any details the administrator requires.
- 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
- Store profile: name, slug (your public URL
/vendors/your-store), logo, description, and contact details. - Customization: the storefront builder exposes a vendor shop customizer for banners and layout on your store page.
- Status: only ACTIVE vendors' products are visible to customers.
Product management
- Vendor → Products → create. Fields mirror the admin product form (title, price, images, variants, category).
- New products enter the review state if the admin enabled manual approval; otherwise they publish immediately.
- Edit any time — changes are versioned by updated-at and reflected on the storefront after publish.
- 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
- Stock lives on the product and each variant. Set quantities when creating/editing.
- Sales decrement stock automatically; low-stock alerts notify you at the threshold the admin configured.
- Set a variant to 0 to sell out without unpublishing the product.
- Digital products have no physical stock handling unless you enable stock tracking for them.
Orders & shipments
- Vendor → Orders: only orders containing your items appear — customer contact is limited to what fulfillment requires.
- Each order shows your sub-order: items, the customer's chosen shipping method, and the shipping charge snapshot.
- Accept and prepare the order, then advance the shipment status (processing → packed → shipped) adding a tracking number and carrier if you have one.
- The customer sees status changes on their order page; notifications go out automatically (no duplicates on retries).
- 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):
| Capability | If allowed by admin |
|---|---|
| Vendor-specific rates | Create your own rates (e.g. item-based pricing) for your items — they take priority over the platform rate where configured |
| Method toggles | Enable/disable specific shipping methods for your store |
| Handling time | Set your preparation days — reflected in delivery estimates |
| Origin address | Set your ship-from address used for zone matching |
| Pickup locations | Create pickup points with address, hours, and instructions |
| Courier account | Connect 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
- Each sale credits your earnings = order total − marketplace commission (rate set by admin).
- Vendor → Earnings/Payouts (where the admin has enabled payouts): see balances and payout history.
- Refunds reduce earnings accordingly.