Setup guide

From sign-up to first points earned in one afternoon.

No engineers, no integrations team, no weeks of onboarding. Here's exactly what happens between requesting access and seeing live points at your counter.

1

Request access (or start a free trial)

Fill in the access request form with your brand name, outlet count and the plan you're interested in. We review it fast — usually same day — and send you a subscription code and next steps by email.

In a hurry? Start a 14-day free trial — verify your email with a 6-digit code and you're in immediately, no waiting for us.

2

Create your account

Use the subscription code we sent (or your auto-issued trial code) to create your Brand Admin account at the registration page. This takes about 2 minutes.

Your account is the master admin for your brand. You can invite additional staff later from the dashboard.

3

Configure your brand rules

Head to the Loyalty Config section of your dashboard and set:

  • Earn rate — e.g. 1 point per ₹10 spent
  • Minimum spend before points are awarded
  • Minimum balance before a guest can redeem
  • Expiry — rolling days of inactivity, or a fixed calendar date
  • Whether points are chain-wide or per-outlet

Optionally turn on time-wise multipliers (e.g. 2× on weekday lunches) and channel multipliers (e.g. dine-in earns more than delivery).

4

Add your outlets

In the Outlets section, create a record for each location — just a name and the city. Each outlet automatically inherits your brand rules. If a specific outlet needs a different earn rate or redemption cap, you can override just the fields that differ.

Outlets can be added one at a time. There's no bulk-import step — most brands add their outlets in 10–20 minutes total.

5

Connect your POS with a scoped API key

Each outlet gets its own API key. Copy the key, paste it into your POS integration settings. If you're running Qmanja POS, this is a single field in the POS admin panel — the POS already knows where to send earn and redeem calls.

Not on Qmanja POS? Use the REST API directly. Two endpoints cover 95% of integrations: POST /earn and POST /redeem. The integration guide and a test console are in your dashboard.

6

Test in the integration console

Before going live with real guests, use the built-in test console (Integration tab in the dashboard) to fire a test earn call, check the resulting balance, then fire a redeem call. Confirm the transaction appears in the ledger.

If something looks off, the console shows you the full request and response so you can debug without digging through logs.

7

Go live — watch points move in real time

Your POS starts sending earn calls the moment an order closes. Points appear on the guest's running balance immediately. From the dashboard you can see the live activity feed across every outlet, the outstanding liability, and per-guest balance lookups.

That's it. No training for staff — the loyalty calculation happens in the background. The POS tells the guest their new balance after each visit.

Before you begin

Common setup questions

No. Guests are identified by their phone number at the counter. No app, no card, no registration form. The POS sends the phone number with each earn or redeem call.

Qmanja Loyalty works with any POS that can make an HTTP call. You integrate with a standard REST API — two endpoints, JSON bodies, scoped API keys. We have integration guides for common scenarios and a test console to confirm everything works before you go live.

Yes, any time from the dashboard. Changes apply to new transactions immediately. Existing earned points are not affected — they stay at the rate they were earned at.

The API is idempotent on your reference ID. If the same ReferenceId is sent twice, the second call returns the original result without creating a duplicate transaction. Points are never double-awarded.

Most brands complete steps 2–6 in under two hours. Adding outlets and pasting API keys into a POS is the longest part — plan about 5–10 minutes per outlet for a first-time setup.

Ready to get started?

Start a free trial in 2 minutes, or send us a request and we'll match you to the right plan.