GroceryHub: 10 Minute App is a complete Quicke Commerce & eCommerce multi-vendor grocery solution designed for seamless online shopping and efficient order management. With location-based ordering, a smart multi-cart system, and admin-controlled cart restrictions, GroceryHub: 10 Minute App ensures a smooth shopping experience. It features a flexible return system, multiple payment gateways, and diverse delivery options, including scheduled delivery, standard delivery, and self-pickup. Whether you're launching a grocery marketplace or optimizing operations, GroceryHub: 10 Minute App is your all-in-one eCommerce solution.

Thank you for choosing GroceryHub: 10 Minute App If you have any questions not covered in this documentation, please feel free to reach out to us via email(support@apksoftwaresolution.com). We’re here to assist and will respond as promptly as possible. Thank you again!

• PHP Version 8.3
• MySQL Version 8.0+ or MariaDB version 10.6+
• BCMath PHP Extension
• Ctype PHP Extension
• cURL PHP Extension
• DOM PHP Extension
• Fileinfo PHP Extension
• GD PHP Extension
• JSON PHP Extension
• Mbstring PHP Extension
• OpenSSL PHP Extension
• PCRE PHP Extension
• PDO PHP Extension
• pdo_mysql PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension
• Filter PHP Extension
• Hash PHP Extension
• Session PHP Extension
• Zip PHP Extension
• allow_url_fopen()
• file_get_contents()

Add New Product

This section enables the admin to add new products to the store. It includes fields for product details such as:

• Product Name, Category & Subcategory, Brand & Seller Details
• Description & Specifications
• Product Images
• Pricing Variaion (Regular Price, Discounted Price)
• Stock & Inventory Management
• Tax Settings
• SEO Settings (Meta Title, Description, Keywords)
• Product Visibility & Status (Active/Inactive)
• Create Product Description Using ChatGPT
• Create Product SEO Content Using ChatGPT
• 

Bulk Import

Allows the admin to upload multiple products at once using a CSV/Excel file. Key features:

• CSV format template for easy bulk upload
• Mapping product details (Name, Price, Category, Stock, etc.)
• 

Bulk Update

This feature lets the admin update product details in bulk instead of editing them individually. Possible updates include:

• Price changes
• Stock quantity updates
• Category modifications
• Status changes (Active/Inactive)
• Tax adjustments
• 

Taxes

Manage tax settings for products. The admin can:

• Define tax slabs (GST, VAT, etc.)
• Apply taxes to specific products
• 

Key Features:

• Order Management – View, filter, and search customer orders based on order ID, customer name, date, or status.
• Order Status Updates – Change order statuses (Pending, Processing, Shipped, Delivered, Cancelled, Refunded).
• Payment Tracking – Check payment details for online transactions (e.g., Razorpay, PayPal, COD, Paystack, Cashfree & many more coming soon).
• Invoice & Billing – Generate and download invoices for customer orders.
• Order Assignments – Assign orders to delivery agents for tracking.
• Returns & Refunds – Manage return requests and process refunds.
• Order Notifications – Send automated Mobile app notifications to customers about their order status.

Delivery Boy Section – Admin Panel

The Delivery Boy section in the admin panel helps administrators manage delivery personnel, handle financial transactions related to order deliveries.

Add Delivery Boy

Admin can add new delivery personnel by entering details like:

• Name, Mobile Number, Email
• Address & Assigned Service Area
• Vehicle Details (if required)
• Profile Photo & ID Verification
• Login Credentials (Username & Password)
• Status (Active/Inactive)
• 

Manage Delivery Boy

View and manage the list of registered delivery boys. Features include:

• Search, filter, and sort delivery agents
• Edit/update delivery boy details
• Activate/deactivate delivery accounts
• Track performance (total deliveries)
• Assign/unassign orders
• 

Fund Transfer (Commission Payouts to Delivery Boys)

Transfer earned commissions from completed deliveries to the delivery boy’s wallet. Features:

• Approve & process payouts manually
• View transaction history (date, amount, status)
• Filter payouts based on delivery boy, date, or amount
• 

Cash Collection (COD Order Settlement)

Manage cash collected by delivery boys for Cash-on-Delivery (COD) orders. Features:

• Track collected cash from completed COD orders
• Verify and reconcile cash deposits
• Generate cash collection reports
• View transaction history (date, order details, collected amount)
• 

Sales & Reports Section – Admin Panel

This section provides comprehensive insights into sales performance, top-selling products, and payment trends, helping administrators refine their business strategies.

Report Filters

• Selling Report Start Date & End Date – Select a custom date range to analyze sales performance within a specific period.
• Refresh Report Button – Instantly update and fetch the latest report based on the selected date range.

Sales Summary Overview

This section provides key metrics at a glance:

• Total Orders – Displays the total number of orders received within the selected period.
• Total Revenue – Shows the total earnings from all orders.
• Total Discounts – Displays the total discount amount applied to orders.
• Total Refunds – Indicates the total amount refunded to customers.

Top-Selling Products

• Lists the best-performing products based on sales volume.
• Shows product names and their respective sales counts.
• Helps identify popular products that contribute significantly to revenue.

Order Analysis & Payment Insights

• Order Summary – Displays the number of orders, revenue, discounts applied, and refund statistics.
• Orders by Payment Methods – Breaks down the payment preferences of customers, including:
• Cash on Delivery (COD) – Most preferred payment method.
• Razorpay, Paystack, Cashfree – Digital payment methods used by customers.

Business Insights & Recommendations

• Identifies trends in product performance (e.g., strong demand for food items).
• Highlights customer payment preferences, helping admins optimize checkout options.
• Suggests strategies to:
• Improve inventory for best-selling products.
• Enhance product images and descriptions for better customer trust.
• Offer return incentives to boost customer retention.

This AI-powered report provides a comprehensive view of business performance, allowing admins to refine their sales strategies and enhance customer satisfaction.

Commission Payouts

• Automated Commission Calculation – The system automatically adds commission amounts when an order status is marked as Completed.
• Commission Deduction – If an item is returned or refunded, the corresponding commission amount is directly deducted from the seller’s balance.
• Real-Time Updates – Transactions are updated dynamically, ensuring sellers always have an accurate view of their earnings.

Transaction History

• View Detailed Records – Admins can track all transactions, including commission earnings, deductions, and payouts.
• Filter & Search – Easily find specific transactions using filters based on seller name, date range, order ID, or amount.
• Export Reports – Generate and download reports for financial reconciliation.

Payout Processing

• Manual Payouts – Admins can process payouts manually.

Seller Balance & Adjustments

• Seller Wallet – Track available balances and pending payouts.
• Adjustments & Deductions – Admins can manually adjust balances in case of disputes or refunds.
• Notification System – Sellers receive alerts about payouts, deductions, and any pending balance adjustments.

This section ensures a smooth and transparent payout process, helping sellers track their earnings while allowing admins to manage commission settlements effectively.

Payment Gateway – Admin Panel

The Payment Gateway section allows admins to configure and manage different payment methods available for customer transactions. This ensures smooth and secure payment processing for all orders. The platform supports multiple payment gateways, including online and offline options.

Available Payment Gateways

• Cash on Delivery (COD) – Customers pay in cash when receiving their orders.
• Razorpay Payments – Secure online payment processing for debit/credit cards, UPI, and wallets.
• PayPal Payments – International payment gateway for secure transactions.
• Paystack Payments – Popular payment gateway for African markets.
• Cashfree Payments – Instant and secure payment solutions for online businesses.
• 

How to Configure Payment Gateways

Admins need to configure API credentials for each payment gateway before enabling them for customer transactions.

Steps to Configure Payment Gateways:

• Go to Admin Panel → Payment List.
• Select the payment gateway you want to configure.
• Enter the required API credentials (API Key, Secret Key, etc.).
• Enable or disable the payment method as needed.
• Save the settings and test the payment gateway for transactions.

How to Get API Keys for Each Payment Gateway

Razorpay API Key & Secret Key

• Go to Razorpay Dashboard.
• Sign in and navigate to Settings → API Keys.
• Generate a new key and copy the API Key & Secret Key.

PayPal API Credentials

• Go to PayPal Developer Dashboard.
• Log in and create a new REST API app.
• Retrieve the Client ID and Secret Key for sandbox or live mode.

Paystack API Keys

• Go to Paystack Dashboard.
• Log in and navigate to Settings → API Keys.
• Copy the Public Key, Secret Key, and Live Mode settings.

Cashfree API Keys

• Go to Cashfree Dashboard.
• Sign in and access Developers → API Keys.
• Generate and copy the App ID and Secret Key.

Ensuring proper configuration of payment gateways is crucial for secure and hassle-free transactions. Admins can enable or disable specific payment methods based on business needs.

Store Setting

• Store Name – Set the official name of the store.
• Contact Information – Add customer support phone number and email.
• Logo – Upload a store logo for branding.
• Address – Enter the store's physical location.
• 

How to Configure:

• Navigate to Admin Panel → Settings → Store Settings.
• Fill in the store details and upload the logo.
• Save changes to update the store profile.

Country Setting

• Mobile Country Code – Defines the default country code for phone numbers.
• Currency – Sets the default currency for transactions.
• Timezone – Configures the timezone for order timestamps.
• 

How to Configure:

• Navigate to Admin Panel → Settings → Country Settings.
• Select the preferred country code, currency, and timezone.
• Save changes.

Order Setting

• Order Delivery Verification – Displays a 4-digit OTP in the user app for verifying deliveries.
• Minimum Order Amount – Set a minimum cart value required for order placement.
• Additional Charges – Manage extra fees such as packaging or service charges.
• Delivery Method Control – Configure options for Home Delivery, Scheduled Delivery, and Self Pickup.
• 

How to Configure:

• Go to Admin Panel → Settings → Order Settings.
• Enable/disable features and set values accordingly.
• Save settings for the changes to take effect.

Delivery Boy Setting

• Show Earning in App – Allows delivery agents to see earnings per order.
• Bonus Settings – Configure incentive bonuses.
• Cash in Hand – Set the maximum cash a delivery agent can hold.
• 

How to Configure:

• Navigate to Admin Panel → Settings → Delivery Boy Settings.
• Enable/disable the necessary options and set limits.
• Save the settings.

Seller Setting

• Order Cancellation & Completion – Decide if sellers can cancel or complete orders.
• One Seller Cart – Allows multiple products from the same seller in one cart.
• Product Publishing Approval – Require admin approval before publishing new products.
• 

How to Configure:

• Navigate to Admin Panel → Settings → Seller Settings.
• Toggle settings as per store policies.
• Save changes.

Mail Setting (SMTP Configuration)

• Mailer Name – Sender name appearing in emails.
• Host – SMTP server address (e.g., smtp.gmail.com).
• Email ID & Password – Email login credentials.
• Port & Encryption – Defines security protocols (e.g., TLS, SSL).
• 

How to Configure SMTP :

• Go to Admin Panel → Settings → Mail Settings.
• Enter SMTP details:
• Host: Yoursmtpmailserver
• Port: 587 (TLS) or 465 (SSL)
• Encryption: TLS or SSL
• Email & Password: Your credentials
• Save the configuration.

Supported SMS Gateways

• Nexmo (Vonage) – API-based gateway for international messaging.
• Fast2SMS – Popular in India with promotional and transactional SMS support.
• MSG91 – Bulk SMS provider with API access.
• 2Factor – DLT-approved provider for OTP SMS in India.
• Twilio – Global SMS provider with robust API and security.

How to Configure SMS OTP :

• Go to Admin Panel → SMS Gateway.
• Choose your preferred SMS gateway.
• Enter API credentials:
• API Key / SID / Auth Token – As provided by the SMS provider.
• Sender ID – Required for some providers like Nexmo.
• Save the configuration.

Firebase Setting

• API Key – Used to authenticate Firebase services.
• Auth Domain – Specifies the authentication domain.
• Storage Bucket – Stores files such as images and documents.
• Messaging Sender ID – Enables push notifications.
• JSON Service File Content – Contains Firebase credentials.
• 

How to Configure Firebase:

• Visit Firebase Console.
• Create a new project and enable Cloud Messaging.
• Navigate to Project Settings → Service Accounts.
• Download the JSON file and upload it to the admin panel.

Supported SMS Gateways

• Order Pending Message
• Order Received Message
• Order Processed Message
• Order Shipped Message
• Order Out For Delivery Message
• Order Delivered Message
• Order Cancelled Message
• Order Delivery Boy Assign Message
• Order Item Return Request Pending Message
• Order Item Return Request Approved Message
• Order Item Return Request Reject Message
• Order Item Return Request Return To Deliveryboy Message
• Order Item Return Request Return To Seller Message
• Order Update Delivery Date Message

Google API / Recaptcha

• Google Maps API – Enables location-based features.
• Google Speech-to-Text API – Converts speech into text.
• Google reCAPTCHA v3 – Protects login and registration forms from spam bots.
• 

How to Get API Keys:

• Go to Google Cloud Console.
• Create a new project and enable the necessary APIs.
• Generate API keys under APIs & Services → Credentials.
• Copy and paste the keys into the admin panel settings.

Login Setting

• Email Login – Allows users to log in using email and password.
• Google Sign-In – Enables Google-based authentication.
• Phone LogIn using OTP – Enables OTP-based authentication.
• 

How to Enable Google Sign-In:

• Step 1: Enable Google Sign-In in Firebase:
  • Go to **Firebase Console > Authentication > Sign-in method**.
  
  
  
  
  • Enable **Google** and provide a valid support email.
  
  
• Step 2: Get Google Client Id from Google Cloud Console:
  • Go to **Google Cloud Console > Select your Project**.
  • How to select Proiect? Remember Project name that you have entered during create a firebase
  
  • in above image my Project name is groceryhub-app
  
  • Select OAuth Client Id
  
  • We get below Screen, Here choose Application Type: Web Application, Enter Name:Websie google Login
  
  • Authorized JavaScript origins : is you domain Name like https://yourdomain.com
  • Authorized redirect URIs : so this should be like https://yourdomain.com/googlesignin
  • then Save and you will get Clien Id and Client secrets
  • Now jus Copy paste on by one on your Admin panel (here below)
  

Steps to Get Tawk.to Widget Code:

• Go to https://dashboard.tawk.to/ and log in or sign up.
• Click on the desired property (website) you want to manage.
• Go to Administration (gear icon) in the left sidebar.
• Under the Channel section, click Chat Widget.
• Click the Copy Widget Code button to copy the JavaScript embed code.

How to Save Widget Code in Admin Panel:

• Go to Admin Panel → App Settings → 3rd Party Settings.
• Paste the copied Tawk.to widget code into the provided textarea or input field.
• Click Save.
• The widget will now appear on the frontend of your website or application automatically.

Login Setting

• Email Login – Allows users to log in using email and password.
• Google Sign-In – Enables Google-based authentication.
• Phone LogIn using OTP – Enables OTP-based authentication.
• 

How to Enable Google Sign-In:

• Step 1: Enable Google Sign-In in Firebase:
  • Go to **Firebase Console > Authentication > Sign-in method**.
  
  
  
  
  • Enable **Google** and provide a valid support email.
  
  
• Step 2: Get Google Client Id from Google Cloud Console:
  • Go to **Google Cloud Console > Select your Project**.
  • How to select Proiect? Remember Project name that you have entered during create a firebase
  
  • in above image my Project name is groceryhub-app
  
  • Select OAuth Client Id
  
  • We get below Screen, Here choose Application Type: Web Application, Enter Name:Websie google Login
  
  • Authorized JavaScript origins : is you domain Name like https://yourdomain.com
  • Authorized redirect URIs : so this should be like https://yourdomain.com/googlesignin
  • then Save and you will get Clien Id and Client secrets
  • Now jus Copy paste on by one on your Admin panel (here below)
  

ChatGPT API

Leverage AI-powered features such as content creation, automated responses, and data-driven insights.

How to Get ChatGPT API Key:

• Sign up at OpenAI.
• Navigate to API Keys and generate a new key.
• Copy and paste the API key into the admin panel settings.
• 

Email Us: support@apksoftwaresolution.com