Seller guide

Sellers work mainly in the seller console (web). The seller mobile app currently covers the order queue and accepting orders.

1. Joining and KYC

  1. Apply — create the seller application (status DRAFT).
  2. Upload documents — national ID or passport, commercial register, tax card, bank statement. Each document is reviewed individually (pending, approved, rejected). Identity documents are required to submit.
  3. Add a bank account — it must be verified by staff before any payout.
  4. Submit — the application moves to PENDING_APPROVAL and admins are notified.
  5. Review — an admin approves (ACTIVE) or sends it back with a reason. Active sellers can later be suspended and reinstated, or closed.

Sellers and admins must use an authenticator-app second factor (TOTP).

A seller also needs a commission plan assigned by a super admin; a seller without one cannot sell.

2. Team members

The owner invites staff by email and can remove them. Today every invited member gets the same manager-level access; finer roles (such as catalogue-only editors) are modelled but not yet applied.

3. Products, variants and offers

  • A product is the shared listing; variants are its SKUs (size, colour…); an offer is your price, condition and stock on a variant.
  • New products go through moderation: DRAFT → PENDING_REVIEW → APPROVED or REJECTED (sellers are notified of rejections). Only platform staff approve.
  • An offer can only be placed on an approved product. If another seller already lists the product, you add your offer to it and compete in the Buy Box.
  • Every product needs a tax class to be sold.
No bulk upload yet

There is no seller-facing CSV or spreadsheet import. Catalogue imports documented in the repository are developer seed scripts.

4. Warehouses and inventory

  • Create, update and close warehouses; record stock receipts and stock counts.
  • Available stock = on hand minus units reserved by open checkouts. Every movement is logged in an append-only stock ledger.
  • Set a reorder point per item to get a low-stock alert in the console (the default of 0 means never alert). The low-stock email is catalogued but not sent yet.

5. Handling orders

  1. New order — each seller receives its own order group and a "new order" notification. Missing the acceptance deadline alerts the seller and admins.
  2. Accept or reject — accepting confirms the group and immediately creates the delivery task; rejecting cancels your part of the order (and refunds the buyer if paid).
  3. Pack — the group moves to processing.
  4. Ready for pickup — a platform driver collects it. From this point the buyer can no longer cancel.

The Shipments area also supports creating, packing, handing over and cancelling shipments, booking a carrier and printing labels.

6. Returns and disputes

  • Approve or reject each return request. After the item comes back, mark it received; the refund follows.
  • If you reject, the buyer can open a dispute. You have 72 hours to respond; an admin decides for the buyer or for you.
  • Return postage is paid by the seller when the reason is the seller's fault, and by the buyer otherwise.
  • On a refund the seller bears the refunded amount and gets the matching commission back.

7. Earnings and payouts

  • Sales are credited to your payable balance when the order is paid (for COD this is when the order is placed and the cash obligation recorded — see Money rules).
  • Earnings are held for 7 days, then become available.
  • Payouts are created in payout runs started by finance; there is no automatic schedule yet. The minimum payout is 100.00 in the payout currency; payouts above 50,000.00 need a second approval.
  • Finance transfers the money by bank and marks the payout paid; you then receive a settlement statement and a "payout sent" notification.
  • The Finance area shows earnings, the earnings statement, settlements and payouts.

8. Other console areas

Questions (answer buyers), Messages, Reviews (reply publicly), Performance (seller metrics), Invoices, Coupons, Privacy, Tools.

Seller mobile app

Sign-in, order queue, order detail and accepting orders, notifications and account. Packing and the seller tools (barcode, inventory, price, chat, health) are shown as "API pending" and are not usable yet.