Aghaz Docs

What is Aghaz

Aghaz is a complete online-store platform built for selling in Pakistan — cash-on-delivery first, with WhatsApp order updates, courier booking, and analytics built in. You get your own store, your own dashboard, and your own themes; we run the servers.

Think of it as your own Shopify: a storefront customers buy from, and a dashboard where you manage products, orders, customers and everything else.

What every store gets

• A storefront on your own web address, with themes you can fully customise.
• Cash on Delivery and optional Bank Transfer checkout — 4 fields, no account needed.
• WhatsApp order confirmations, delivery updates, and an optional AI assistant that answers customers.
• Courier booking from inside an order (Oshi, InstaCourier, Leopards, PostEx, BlueEx, TCS, Trax).
• Analytics — live visitors, sales by channel (Facebook / Instagram / TikTok / Google), best sellers.
• A read-only API and a command-line tool for developers.

Getting started

Getting a store live takes a few minutes and no payment.

1. Go to aghaz.pk and press Create your store.
2. Pick a store name and your store address (the part before .aghaz.pk).
3. Enter your email — we send a 6-digit code to verify it.
4. Type the code. Your store is provisioned instantly and you land in the dashboard.

Signing in later

Your dashboard lives at admin.aghaz.pk/store/your-store. Bookmark it. You can also sign in from the Log in link on aghaz.pk.

First things to do

• Add your first product (see Products).
• Pick and publish a theme (see Themes).
• Connect WhatsApp so customers get order updates (see WhatsApp).
• Set your payment methods in Settings → Payments.

The dashboard

The dashboard is organised down the left sidebar. Here is what each area does.

Products

A product is one thing you sell. Open Products → Add product.

1. Give it a name and a price (and an optional compare-at price to show a discount).
2. Write a description. Add photos — drag to reorder; the first is the cover.
3. Set stock. When an order is delivered, stock goes down automatically.
4. Add a slug and SEO title/description if you want (defaults are generated).
5. Press Save. Your product is live at /products/your-slug.

Photos and video

• Photos and video live in one ordered gallery — drag the tiles to set the order customers see.
• Video is supported (mp4/webm). A .mov you upload is converted to MP4 automatically.
• The cover image is always a photo (it shows in the cart, checkout and orders list), never a clip.

Variants & options

Variants are the versions of a product — sizes, colours, or packs (e.g. Single / 2-Pack / 3-Pack). Each variant can carry its own price and its own stock.

1. Open a product and go to its Variants section.
2. Add an option (e.g. Size) and its values (e.g. S, M, L).
3. For each variant, set a price and stock if it differs from the base.
4. Save. The storefront shows a picker, and stock tracks per variant.

Bundles

A bundle sells several products together at one price — a deal like "Buy 3, save 20%".

1. Go to Products and add a Bundle.
2. Give it a name and a bundle price.
3. Choose the products (and quantities) that make up the bundle.
4. Save. It gets its own product page and checks out like any product.

Orders & checkout

Customers check out with just 4 fields (name, phone, city, address) — no account needed. Email is optional.

Payment methods

• Cash on Delivery — the default. Pay when the parcel arrives.
• Bank Transfer — optional (Settings → Payments): add Meezan / Easypaisa / JazzCash etc., with an optional extra discount. The discount is re-checked on the server, so the total is always trustworthy.

The order pipeline

Every order moves through a set of statuses. Each change emails the customer (if they gave an email) and is logged.

Adding an order by hand

Taking an order over the phone? Use Orders → New order — a full page (not a popup). If the phone already belongs to a customer, it tells you and links to them; it never silently overwrites a profile.

Tracking

Add a tracking id and link on the order page. Customers can follow it at /track-order.

Customers & anti-fraud

Every order builds a customer profile keyed on the phone number, so repeat buyers and their history are one click away.

Reducing returns (RTO)

• Phone blacklist — block a number from ordering.
• Repeat-offender flag — a phone with too many returns is flagged automatically.
• RTO report (Orders → Returns) — return rate by courier, city and month.
• Order rate-limit per IP, honeypots, and repeat-phone history all run quietly in the background.

Couriers & shipping

Book a shipment straight from an order — no separate courier portal.

1. Turn on the couriers you use in Settings → Couriers (each has its own on/off and API fields).
2. Open an order and press Book courier; pick a courier and confirm.
3. The tracking number comes back onto the order, and status updates flow through the pipeline.

Adapters available: Oshi, InstaCourier, Leopards, PostEx, BlueEx, TCS, Trax. Oshi and InstaCourier are verified live; the rest activate once you add API keys.

Payments & discounts

Payments live in Settings → Payments: enable Cash on Delivery and any Bank Transfer methods, each with an optional extra discount for prepaid orders.

Themes

Your storefront's look is a theme. Open Themes to install, preview, customise and publish.

Two engines

• Classic — Aghaz's own themes, fast and fully supported.
• Liquid — import a Shopify-style theme (Dawn and others). Great if you are moving from Shopify.

Editing a theme

• Customize — a visual editor: click a section in the preview, change its settings, save. Changes go live for a published theme.
• Edit code — a full code editor (like Shopify's "Edit code") for anyone who wants the files directly.

1. Pick a theme and press Customize to style it, or Edit code for the files.
2. Use Preview to see changes before they are public.
3. When happy, press Publish. That theme becomes your live storefront.

Editing theme code

The code editor is a VS-Code-style editor built into the dashboard. It saves safely — broken PHP or broken JSON is refused before it can reach your live store, and every save is kept in a timeline you can roll back.

Prefer to work on your own computer? Use the CLI (see the Developers section) to pull the theme down, edit it in your own editor, and push it back.

WhatsApp

Aghaz can send order updates over WhatsApp and — if you switch it on — let an AI assistant answer customer messages.

Connecting a number

1. Open WhatsApp in the dashboard.
2. Scan the QR code with the phone whose number you want to send from.
3. Once linked, notifications start flowing.

What it sends

• Order confirmation, dispatch and delivery updates, and more — all editable templates.
• Follow-up messages and polls you design (any depth).
• Optional AI assistant that replies to customer questions and can even take an order — prices always come from your catalogue, never invented.

Pausing

Two independent switches: pause customer notifications, or pause the AI assistant, without touching the other. A pause can be "until I resume" or auto-expire after a set time.

Analytics

The dashboard home is your analytics view.

• Live visitors right now.
• Sales by channel — Facebook, Instagram, TikTok, Google, Direct, Referral, WhatsApp.
• Orders by status, conversion rate, delivered sales, best sellers.

API (v1)

A read-only JSON API, one key per store. Turn it on and generate a key in Settings → API.

Authenticating

Send your key as a Bearer token. Keys are never stored on our side — only a fingerprint — so keep yours safe.

curl https://your-store.aghaz.pk/api/v1?r=ping \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

Call as /api/v1?r=<endpoint>. All are GET. Rate limit: 120 requests per minute.

Example

# last 10 delivered orders
curl "https://your-store.aghaz.pk/api/v1?r=orders&status=delivered&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "ok": true,
  "page": 1,
  "limit": 10,
  "orders": [
    { "order_no": "AB-76", "name": "…", "total": 1199, "status": "delivered", … }
  ]
}

Command-line tool (Aghaz CLI)

The Aghaz CLI lets you work on your theme from your own computer — pull it down, edit it locally, and push it back. It works the way Shopify's CLI does: a secure browser login, no key ever pasted.

Install

It runs on Node.js 18 or newer and has no dependencies.

# once you have the CLI folder
cd aghaz-cli
npm link
# now `aghaz` works from any folder

Sign in

You never type your store name — the CLI finds it from the dashboard you are signed into in your browser.

aghaz auth login
# a browser opens → press Connect → done
aghaz auth whoami   # check the connection

Working on a theme

aghaz theme list                 # every theme in your store
aghaz theme pull                 # download the live theme
#   … edit the files in your editor …
aghaz theme push                 # upload what you changed
aghaz theme dev                  # push every save, as you save

• Commands act on your live theme unless you pass --theme=<id>.
• Only files that actually changed are transferred, so pull/push are fast.
• push --delete also removes files you deleted locally.

What the CLI can touch

A CLI connection can only read and write your own store's theme files — nothing else. It cannot see orders, customers or settings, it cannot reach another store, and broken PHP or JSON is refused before it can reach your live storefront.

FAQ

Is it really free?

Yes, while we are in early access. Paid plans come later; your store keeps working.

Can I use my own domain?

Yes — add it in Settings → Domain. SSL is issued automatically.

Do customers need an account to buy?

No. Checkout is 4 fields; email is optional. That is what keeps COD conversion high.

I deleted something by accident.

Check Super Admin → Recovery — customers, orders, products and media are all recoverable from the recycle bin.

I moved from Shopify — can I bring my data?

Yes. Import orders, products and customers from a Shopify CSV in Settings → Backups & Data / Import. You can import a Shopify-style (Liquid) theme too.

How do I get help?

Use the Store Assistant in your dashboard — it answers questions and can file a support ticket for you. Or email us from the aghaz.pk contact page.