Introduction

meBUY is a full-featured multi-vendor e-commerce platform with support for retail, wholesale, pre-orders, live video shopping, logistics, and human resources management. This tutorial covers every module from both the user and administrator perspective.

Base URL: http://localhost:8000 (local) or your production domain. All URLs in this tutorial assume the base path.

Registration & Login

Creating an Account

  1. Navigate to /register or click Sign Up
  2. Enter your name, email, phone, and a secure password
  3. Click Register to create your account
  4. Check your email and click the verification link (if email verification is enabled)

Signing In

  1. Go to /login and enter your email + password
  2. Check Remember Me to stay logged in
  3. Click Log In

Social Login

Login with Google or Facebook via OAuth. Click the corresponding icon on the login page. First-time social logins automatically create an account.

Password Reset

Forgot your password? Go to /forgot-password, enter your email, and follow the link sent to your inbox to set a new password.

Demo Credentials: Email customer@mebuy.com — Password customer123 (pre-seeded customer account).

User Roles

The platform supports four user roles, each with a distinct interface:

Role Dashboard Capabilities
Customer /customer/dashboard Browse, purchase, pre-order, live shopping, wallet, reviews
Promoter /promoter/dashboard Host live sessions, analytics, commissions, wallet withdrawals
Admin /admin/dashboard Full system management (products, orders, users, settings, logistics, HRM)
Logistics /admin/logistics/dashboard Client shipments, pickups, container rates, finance & invoicing

Browsing Products

Home Page

The home page (/home) showcases featured products, new arrivals, categories, flash sales, and promotional banners. Scroll through sections or use the navigation bar to explore.

Product Listing

Visit /products to browse all products. Use the sidebar filters to narrow by category, price range, brand, or rating. Sort by newest, price (low-to-high / high-to-low), or best selling.

Search

Type in the search bar at the top of any page. Search results show matching products. You can also access /products/search?q=keyword directly.

Product Detail Page

Click any product to view: images, description, price, SKU, stock status, variants (color/size), reviews, and the “Add to Cart” button. From here you can also add items to your wishlist.

Special Collections

🔥 Today's Deals 📦 New Arrivals 🌟 Best Sellers 🚚 Ready to Ship ⚡ Flash Sale 📁 All Categories

Shopping Cart

Adding Items

On any product detail page, select quantity (and variant if applicable), then click Add to Cart. A confirmation toast will appear.

Viewing & Managing Cart

Visit /cart to see all items. From here you can:

Cart contents persist across sessions if you're logged in. Guest carts use session storage and will merge when you log in.

Checkout & Payment

Checkout Flow

  1. Go to /cart and click Proceed to Checkout
  2. Select or add a shipping address
  3. Choose a shipping method
  4. Apply a coupon code (optional)
  5. Select payment method:
    • Paystack — debit/credit card (Africa-focused)
    • Stripe — credit/debit card (global)
    • Flutterwave — multiple African payment methods
    • PayPal — international payments
    • Wallet — pay from your meBUY wallet balance
    • Cash on Delivery — pay when order arrives
  6. Review order summary and click Place Order

Payment Callback

After completing payment on the gateway's page, you are redirected back to the platform where the order status updates automatically. For wallet or COD payments, the order is confirmed immediately.

Webhook: Payment gateways also send server-side webhooks (/payment/webhook/{gateway}) to ensure order status is always correct, even if the user closes the browser during redirect.

Orders & Tracking

Viewing Orders

Go to /customer/orders (logged in) to see all your past orders. Each order shows the status, items, total, and payment status.

Order Detail

Click any order to view full details: items, shipping address, payment info, status history, and tracking information once shipped.

Receipt

Each order has a printable receipt at /orders/{orderNumber}/receipt.

Tracking

Use the tracking page at /track-order to enter an order number and see real-time shipping status. You can also track logistics shipments by tracking number or shipping mark.

🔎 Track Order 🚚 Logistics Tracking

Wishlist

Adding Items

Click the heart icon on any product card or detail page to add it to your wishlist. A filled heart means the item is saved.

Managing Your Wishlist

Visit /wishlist to view all saved items. From there you can:

Your wishlist is also accessible from the customer dashboard at /customer/wishlist.

Coupons & Deals

Applying Coupons

During checkout, enter your coupon code in the “Apply Coupon” field. The discount (percentage or fixed amount) is applied immediately. Only valid, non-expired, usage-limited coupons are accepted.

Deals & Flash Sales

Special pricing pages (/deals, /flash-sale) showcase products with temporary discounts. These are managed by admins through campaigns. Products on flash sale show a countdown timer and special badge.

Pre-Orders & Sourcing

Customer

Pre-Orders (China Warehouse)

Products marked as Pre-Order are sourced from our China warehouse. When you place a pre-order:

  1. Select the product on the listing or detail page
  2. Specify quantity and any variant options
  3. Submit the pre-order request
  4. Track the status in /customer/pre-orders

Pre-orders go through statuses: Pending → Processing → Shipped → Delivered.

Sourcing / Custom Orders

Need a product we don't carry? Use the Request a Product feature at /sourcing-request or /custom-order:

  1. Fill out the form with product details, quantity, budget, and reference links
  2. Optionally upload a reference image
  3. Our team reviews and responds with a quote within 48 hours
  4. If approved, the sourcing becomes a pre-order you can track
Custom sourcing is ideal for wholesale quantities (MOQ 50+ units) or hard-to-find items from China.

Wholesale

Public

Browsing Wholesale Products

Visit /wholesale to browse wholesale products with tiered pricing (e.g., 10-49 units, 50-199 units, 200+ units). Wholesale products have separate listings, images, and bulk pricing tables.

Wholesale Cart & Checkout

  1. Add items from the wholesale listing page to your wholesale cart
  2. Review your cart at /wholesale/cart
  3. Proceed to wholesale checkout
  4. After checkout, view your wholesale orders at /wholesale/orders

Wholesale Receipt

Each wholesale order generates a receipt accessible at /wholesale/orders/{orderNumber}/receipt for printing or record-keeping.

Live Shopping

Customer

What is Live Shopping?

Promoters host live video sessions showcasing products in real-time. Customers can watch, chat, react, and purchase featured products during the stream.

Joining a Session

  1. Go to /customer/live-sessions to see upcoming and active sessions
  2. Click on a session to join (opens Daily.co video room)
  3. During the stream, browse featured products and add them to cart
  4. Send chat messages and react with emojis

Promoter's Role

Promoters create and manage sessions from /promoter/sessions, set a schedule, add featured products, start/end the stream, and view engagement analytics.

Live video is powered by Daily.co. Room URLs open in the browser — no native SDK required. Promoters need a Daily.co API key configured in settings.

Wallet System

Customer

Overview

The wallet allows users to store funds, pay for orders, send money to other users, and withdraw to their bank account.

Wallet Operations

Wallet PIN

Set a wallet PIN for security when sending money or making large transactions. Update it from your wallet settings.

Admin Wallet

Admins have their own wallet for making deposits, withdrawals, and transfers. The admin can also manage all user wallets from /admin/user-wallets.

💰 My Wallet 📋 Transaction History

Chat & Support

Customer

Starting a Chat

From the customer dashboard, go to /customer/chats and start a new conversation with support. You can attach images and send messages in real-time via Laravel Reverb WebSockets.

Chat Features

Contact Form

Use the form at /contact for general inquiries. Messages are stored in the database and emailed to the notification address configured in Settings.

Customer Dashboard

Customer

After login, the customer dashboard is at /customer/dashboard. It provides an overview of:

📊 Dashboard 📦 My Orders 🤍 Wishlist 💰 Wallet 💬 Chat Support 📍 Addresses

My Orders

Customer

The /customer/orders page lists all orders with filters by status (pending, processing, shipped, delivered, cancelled). Each row shows:

Click View to see the full order detail with all items, shipping address, payment info, and status timeline.

Addresses

Customer

Manage your shipping and billing addresses at /customer/addresses. You can:

Refunds

Customer

Requesting a Refund

  1. Go to /customer/refunds and click Request Refund
  2. Select the order and item(s) to refund
  3. Choose a reason (defective, wrong item, not as described, etc.)
  4. Add details and optionally upload photos
  5. Submit the request

Refund Statuses

Refund requests go through: Pending → Approved → Processed (or Rejected). Once processed, the refunded amount is credited to your wallet or the original payment method, depending on settings.

Reviews

Customer

Writing a Review

After purchasing a product, you can leave a review from the order detail page or from /customer/reviews. Rate the product (1-5 stars) and write a text review. You can also upload images.

Managing Reviews

View all your reviews at /customer/reviews. You can edit or delete your reviews. Admins may approve or reject reviews before they appear publicly.

Promoter Dashboard

Promoter

Promoters are affiliate sellers who host live shopping sessions. The promoter dashboard (/promoter/dashboard) shows:

📊 Dashboard 🎬 Live Sessions 📈 Analytics 💰 Wallet 💸 Payouts 💬 Chats

Live Sessions

Promoter

Creating a Session

  1. Go to /promoter/sessions and click Create Session
  2. Set title, description, scheduled start time
  3. Select featured products to showcase during the stream
  4. Choose a thumbnail image
  5. Save the session (Daily.co room is auto-created)

Running a Session

  1. When it's time, click Start Session
  2. The Daily.co video room opens in a new browser tab
  3. Customers can join from /customer/live-sessions/{session}
  4. Engage with viewers via chat and reactions
  5. Click End Session when done

Session Analytics

Each session shows: peak viewers, total chat messages, reactions, products viewed, and sales generated. Use these insights to improve future streams.

Earnings & Payouts

Promoter

Commission Structure

Promoters earn a commission on sales generated through their live sessions. Commission rates are configurable in admin settings.

Withdrawing Earnings

  1. Go to /promoter/wallet to view your balance
  2. Click Withdraw and enter the amount
  3. Provide your bank account details (name, account number, bank)
  4. Submit the withdrawal request
  5. Admin reviews and approves/rejects the request
  6. Once approved, funds are transferred to your bank or wallet

Payout History

View all past payouts and their status at /promoter/payouts.

Admin Dashboard & POS

Admin

Dashboard

The admin dashboard (/admin/dashboard) provides a business overview with key metrics:

POS (Point of Sale)

The POS system at /admin/pos allows in-person sales at a physical store:

  1. Search and add products to the POS cart
  2. Adjust quantities as needed
  3. Select customer (or create walk-in customer)
  4. Choose payment method (cash, card, wallet, etc.)
  5. Complete the sale — order is created and receipt is generated
  6. Process card payments via the integrated terminal

User Impersonation

Admins can Login As any user to troubleshoot or assist. Use the Login As button on the user detail page. To stop, click Stop Impersonating in the header.

Product Management

Admin

Products Overview

The product management section (/admin/products) lists all products with search, filter, and bulk actions. Navigate sub-tabs for different types:

Creating / Editing Products

  1. Navigate to /admin/products/create
  2. Set title, description, SEO meta, and tags
  3. Select category, brand, and attributes (color, size)
  4. Set pricing (regular, sale, wholesale tiers)
  5. Configure stock (quantity, SKU, warehouse)
  6. Upload images and set primary image
  7. Set status (published/draft) and features (featured, today's deal)
  8. Save the product

Bulk Actions

Product Attributes

Manage attribute sets (e.g., "Clothing Sizes") and attribute values (e.g., S, M, L, XL) to create product variants with different pricing and stock. Accessible from the Products sub-menu.

Colors & Brands

Define color swatches and brand names used across products. Brands and colors can be managed from their respective sub-pages with CRUD operations.

Categories & Brands

Admin

Categories

Manage the category tree at /admin/categories:

Brands

Manage brands at /admin/products/brands with name, logo, and description. Brands are linked to products for filtering and display.

Order Management

Admin

Orders List

The orders page at /admin/orders shows all orders with filters by status, payment method, date range, and search by order number or customer. Each row shows key info at a glance.

Order Detail & Actions

Click any order to view full details. From the detail page an admin can:

Pickup Hub Orders

Orders assigned to pickup hubs are managed at /admin/orders/pickup-hub. Manage hub locations and order routing at /admin/pickup-hubs.

Customer Management

Admin

The customers section at /admin/customers provides full customer lifecycle management:

Customer List

View all registered customers with search, filter by status, and export. Special filtered views:

Customer Detail

Click any customer to see their profile, order history, wallet transactions, and support chats. From here you can:

Import Customers

Bulk-import customers via CSV with a downloadable sample template at /admin/customers/import.

Notify Customers

Send email notifications to selected customers from /admin/customers/notify. Compose subject and message, and choose recipients (all customers, verified only, or specific segments).

Campaigns & Promotions

Admin

Campaigns

Create marketing campaigns at /admin/campaigns:

  1. Set campaign name, description, start/end dates
  2. Choose campaign type (regular, flash sale, seasonal)
  3. Select products included in the campaign
  4. Set discount type (percentage or fixed) and value
  5. Toggle featured or flash-sale status
  6. Enable/disable as needed

Campaign Requests

Promoters or vendors can submit requests to join campaigns. These appear at /admin/campaign-requests for admin review. Approve or reject requests with optional admin notes.

Coupons

Manage discount coupon codes at /admin/coupons:

Wholesale Management

Admin

Wholesale Products

Manage wholesale-specific products at /admin/wholesale. These are separate from retail products with their own pricing tiers, images, and inventory.

Creating Wholesale Products

  1. Go to /admin/wholesale/create
  2. Set product name, description, images
  3. Define tiered pricing (e.g., 10-49 pcs @ $5, 50-199 pcs @ $4, 200+ @ $3)
  4. Set minimum order quantity (MOQ)
  5. Configure stock and SKU
  6. Save product

Share Retail to Wholesale

On any retail product edit page, use the Share to Wholesale action to clone it as a wholesale product.

Wholesale Settings

Configure global wholesale settings at /admin/wholesale/settings: email notifications, default MOQ, and pricing display preferences.

CMS & Banners

Admin

Content Management (CMS)

Manage static page content at /admin/cms. Sections include:

Each CMS entry supports rich text content, SEO fields, and active/inactive toggling.

Hero Banners

Manage homepage hero slider at /admin/hero. Each banner has:

Footer Content

Customize footer links, logo, and company info at /admin/footer. Manage social media links, quick links, and contact information displayed site-wide.

Media Library

Upload and manage all media assets at /admin/media. Supports images, documents, and videos with folder organization. Used across products, banners, CMS, and brand assets.

Sourcing Requests

Admin

Customer sourcing requests are managed at /admin/sourcing:

Settings

Admin

The unified settings page at /admin/settings has multiple tabs:

General Settings

Payment Gateway

Bank Transfer

Configure bank account details displayed to customers for manual bank transfer payments.

Social Login

Enable/disable Google and Facebook login. Enter OAuth client IDs and secrets for each provider.

Email Setting

Notifications

Toggle email/SMS notifications for key events:

SMS Notification

Configure bulk SMS provider (Twilio, Africa's Talking, etc.) and send bulk SMS campaigns to customers from /admin/bulk-sms.

Other Settings Tabs

Reports & Analytics

Admin

Access comprehensive business reports from the admin sidebar or /admin/analytics:

📈 Analytics Dashboard 💰 Product Sales 💳 Commission History 💱 Wallet Recharges 📦 Stock Report 🤍 Wishlist Report 📊 Price & Stock 🔎 Search Logs

Reports Available

Logistics System Overview

Logistics

The logistics module manages end-to-end shipping, warehousing, and freight operations. Access from the admin sidebar under Logistics or /admin/logistics/dashboard.

Key Features

Shipments & Pickups

Logistics

Creating a Shipment

  1. Go to /admin/logistics/shipments/create
  2. Select client/customer (or create new)
  3. Enter shipment details: origin, destination, package dimensions, weight
  4. Select container rate (air, sea, land with pricing)
  5. Generate tracking number and shipping mark
  6. Save to create the shipment record

Managing Shipments

From the shipments list (/admin/logistics/shipments):

Pickups

Manage pickup requests at /admin/logistics/pickups:

Container Rates

Define pricing for different shipping methods at /admin/logistics/container-rates. Each rate has:

Branches

Manage branch office locations for pickups and deliveries at /admin/logistics/branches.

Logistics Finance & Invoices

Logistics

Invoices

Payments

Accounts Receivable

Track outstanding client balances at /admin/logistics/finance/accounts-receivable.

Expenses

Record and approve logistics-related expenses (fuel, customs, warehousing) at /admin/logistics/finance/expenses.

Reports

Generate financial reports at /admin/logistics/finance/reports with printable versions for accounting.

Logistics Client Portal

Logistics

Logistics clients have their own portal for self-service:

Client Login

Clients log in at /logistics/client/login using their credentials (managed separately from the main platform users).

Client Dashboard

After login, clients can:

HRM System Overview

HRM

The Human Resources Management module handles employees, attendance, leaves, payroll, performance reviews, and recruitment. Access from admin sidebar under HRM.

📊 HR Dashboard 👥 Departments 👤 Employees 📅 Attendance 🏠 Leaves 💰 Payroll 🎉 Holidays 🔍 Recruitment

Employee Management

HRM

Departments & Designations

Set up the organizational structure first:

Adding Employees

  1. Go to /admin/hrm/employees/create
  2. Enter personal details (name, email, phone, address)
  3. Select department and designation
  4. Set joining date, salary, and employment type (permanent/contract/intern)
  5. Upload photo and documents
  6. Save — employee record is created

Bulk Import

Import multiple employees via CSV at /admin/hrm/employees/import with a downloadable sample template.

Sync Promoters

Automatically create employee records from existing promoter accounts using the Sync Promoters feature.

Attendance & Leaves

HRM

Attendance

Leaves

Payroll & Performance

HRM

Payroll

Performance Reviews

Recruitment

Frequently Asked Questions

How do I reset my password?

Go to /forgot-password, enter your registered email, and click the reset link sent to your inbox.

What payment methods are accepted?

We accept Paystack, Stripe, Flutterwave, PayPal, wallet balance, and cash on delivery (depending on location).

How long does shipping take?

Domestic orders typically arrive in 3-7 business days. International pre-orders from China take 15-30 days depending on shipping method.

Can I cancel an order?

Orders can be cancelled while in Pending status. Go to /customer/orders, find the order, and click Cancel.

How do I track my order?

Use the tracking page at /track-order with your order number, or go to /customer/orders and click View/Track on any order.

How do I become a promoter?

Contact the admin to upgrade your account to the promoter role. Promoters can host live shopping sessions and earn commissions.

How do I request a product you don't carry?

Use the Request a Product form at /sourcing-request. Our team will review and respond with a quote.

Contact & Help

Need additional help? Here are your options:

Quick Access: Bookmark /system/tutorial.html for future reference. This tutorial is also linked from the admin sidebar.
meBUY System Tutorial — Version 1.0
© 2026 meBUY. All rights reserved.