Getting Started

What is GrubFairy?

GrubFairy is a next-generation food delivery platform powered by AI. We connect customers with the best local food based on their unique taste profiles, help vendors reach the right audience without expensive ads, and provide riders with flexible, well-paid work.

Platform Overview

Customer App AI-powered food discovery and ordering interface.
Vendor Portal Dashboard for menu management, orders, and analytics.
Rider App Navigation, order acceptance, and earnings tracking.

Basic Terminology

Commission:: Percentage fee charged on orders to cover platform costs.
Zones:: Geographic areas defining delivery coverage and pricing.
Payouts:: Weekly settlements transferred to vendor/rider bank accounts.

Vendor Documentation

How to Onboard

Onboarding is automated. Download the Vendor App, submit your business documents (CAC, Hygiene Certificate), and create your profile. Verification usually takes 1–2 business days.

Menu Setup & Management

Menus are structured as:


Category (e.g., "Soups")

↳ Item (e.g., "Egusi Soup")

  ↳ Variations (e.g., "Goat Meat", "Fish")

  ↳ Add-ons (e.g., "Extra Fufu")

High-quality photos are mandatory. Our AI checks images for lighting and composition before approval.

Order Lifecycle

Order Received → Preparing → Ready for Pickup → Picked Up → Delivered

Vendor Tiers

Standard: Default listings, standard commission.
Boost: Higher visibility in search and AI recommendations, paid subscription or lower commission tier.

Technical Docs

Authentication

All API requests must include your API key in the header:


Authorization: Bearer YOUR_API_KEY

Webhooks

Subscribe to events to get real-time updates:

order.created
order.status_updated
menu.item_approved

Rate Limits

Standard tier: 60 requests per minute. Boost tier: 300 requests per minute.

Payments & Fees

Fee Structure

Commission

Variable % based on order volume and vendor tier. Covers platform maintenance and marketing.

Delivery Fee

Paid by customer. Dynamically calculated based on distance and traffic.

Refunds & Disputes

Refunds are processed for missing items or severe quality issues. Disputes are handled via our support team with evidence (photos) required.

Logistics & Delivery

Our assignment logic prioritizes:

Rider proximity to vendor.
Rider rating / reliability score.
Vehicle type (Bike vs Bicycle for short distance).

Peak Hour Behavior

During high demand, delivery radius may shrink dynamically to ensure timely deliveries for core zones.

Security & Compliance

We adhere to strict data protection standards (NDPR/GDPR compliant). All payment data is tokenized and processed by PCI-DSS certified partners.

Fraud prevention systems analyze order patterns to detect chargeback risks and fake account creation.

FAQs

Vendor: When do I get paid?

Payouts are processed every Tuesday for the previous week's earnings (Mon-Sun).

Rider: Can I reject orders?

Yes, but frequent rejections without cause may affect your reliability score and assignment priority.

Customer: My order is late.

Use the in-app chat to contact support. We track all riders in real-time.

Product Roadmap

In progress

Abuja launch

Onboarding our first vendors and riders, and opening the customer waitlist across Abuja.

AI craving recommendations

A personalized "for you" feed that learns your taste, budget, and timing.

Planned

Vendor analytics & FairyBoost

Deeper insights and promotion tools for our partner restaurants.