1. 🚀 Getting Started
  2. ⚡ Quickstart Guide
MudraHQ AppAdmin ConsoleGitHub
  • ⚡ MudraHQ Overview
  • ⚡ Quickstart Guide
  • 🏗️ System Architecture

⚡ Quickstart Guide

Get up and running with MudraHQ in under 2 minutes — from merchant onboarding to your first GST-compliant tax invoice.

Loading documentation…

⚡ MudraHQ Overview< Previous🏗️ System ArchitectureNext >

Powered by heyo-docs

On this page

🎯 Step 1: Merchant Account Creation🏢 Step 2: Configure Business & GST Identity📦 Step 3: Add Your First Inventory Item🧾 Step 4: Issue Your First Tax Invoice🚀 Next Steps

Welcome to MudraHQ! This guide walks you through setting up your business profile, configuring your GST credentials, adding your first inventory items, and generating a tax invoice with an integrated UPI QR code.


🎯 Step 1: Merchant Account Creation

  1. Navigate to the live web interface at https://mudrahq.tech.
  2. Click Create Account to open the registration wizard.
  3. Enter your:
    • Full Name & Contact Number: Used for SMS alerts and WhatsApp ledger sharing.
    • Business Email & Secure Password: Stored with salted BCrypt (12 rounds).
    • DPDP Statutory Consent: Check the box confirming consent under Section 5 of the Digital Personal Data Protection Act 2023.
  4. Click Complete Setup to launch directly into the Onboarding Wizard.

🏢 Step 2: Configure Business & GST Identity

In the Onboarding Wizard or under Settings ➔ Business Profile:

  1. Business Name: Your trade name as registered on the GST portal (e.g., Madel Retail Solutions).
  2. GSTIN: Enter your 15-digit GST identification number (e.g., 36AABCM1429B1Z4).
    • MudraHQ automatically detects your state jurisdiction and sets up CGST/SGST vs IGST billing rules.
  3. UPI ID (VPA): Enter your business UPI handle (e.g., billing@okaxis or merchant@hdfcbank).
    • This powers the instant dynamic payment QR code printed on every customer bill.
  4. Invoice Prefix: Choose your billing prefix (e.g., INV/2026/ or BILL-).

📦 Step 3: Add Your First Inventory Item

Navigate to the Products tab from the bottom navigation bar:

  1. Tap the + Add Product button.
  2. Fill in the product details:
    • Name: e.g., Industrial Rotary Hammer Drill 850W
    • Category: e.g., Power Tools
    • HSN Code: e.g., 8467
    • Selling Price: e.g., ₹4,200.00
    • GST Tax Rate: Select 18% (system automatically splits to 9% CGST + 9% SGST)
    • Stock Quantity: Enter opening stock (e.g., 25 PCS)
  3. Tap Save Product.

🧾 Step 4: Issue Your First Tax Invoice

  1. From the Dashboard or Customers tab, tap + New Sale Bill.
  2. Select an existing client or tap Add Customer (enter phone and name).
  3. Tap Add Items and select your Hammer Drill. Set quantity to 2.
  4. Review the auto-computed financial breakdown:
    • Subtotal: ₹8,400.00
    • CGST (9%): ₹756.00
    • SGST (9%): ₹756.00
    • Total Amount: ₹9,912.00
  5. Tap Generate & Print:
    • A professional GST invoice is generated with an immutable invoice sequence number.
    • The customer receives a real-time WhatsApp statement with an integrated payment link.
    • Inventory is instantly decremented from 25 to 23 PCS across all connected terminals.

🚀 Next Steps

  • Explore the Multi-Terminal POS Engine
  • Review Dual GST Calculation Architecture
  • Integrate with the Developer REST API