Back to Home

Setup guide

How to Set Up QR Print

Up and running in minutesNo technical knowledge needed

This guide takes you from shop registration to your first test print. Follow each step in order. The optional Razorpay section is only needed when your shop accepts online payments.

STEP 1–8

Set Up the Print Software

These steps are needed for both cash and online-payment shops.

01

Create your shop account

Open Register Shop, enter the shop and owner details, and create a password. Your shop QR link and private agent secret are created automatically.

02

Log in to the Shop Panel

Use your email and password on Shop Login. The dashboard shows agent status, wallet or subscription details, recent jobs and your customer QR.

03

Add your printer

Open Printers, choose the brand and model, and enter the exact printer name shown by Windows. The newest printer becomes the default.

04

Start the Print Agent

On the shop PC, run the PowerShell Print Agent. It connects with the shop agent secret and keeps checking securely for queued jobs.

powershell -ExecutionPolicy Bypass -File D:\xampp\htdocs\qrprint\agent\heartbeat.ps1
05

Confirm Agent Online

Return to the Dashboard. The Print Agent indicator should become Online after its next heartbeat. Keep the agent running in the background.

06

Set customer prices

Open Print Settings. The recommended starting prices are ₹3 for B&W A4 and ₹8 for color A4. Enable cash, online payment, or both.

07

Open the customer QR page

From the Dashboard, press Open Print Page or scan the displayed QR from a phone. Select a test PDF or image and choose the print options.

08

Print and confirm

Submit the test job. When Windows sends it to the printer, its status becomes Picked. Confirm Printed only after the paper physically comes out.

OPTIONAL 1–7

Online Payment Setup with Razorpay

Skip this section when your shop accepts cash only.

01

Create a Razorpay account

Register your business at razorpay.com and complete the required account verification.

02

Add your business details

Use your real shop and website details. Select the business category that accurately represents your shop.

03

Complete KYC

Provide the bank, PAN and identity documents requested by Razorpay for your account type.

04

Generate live API keys

After activation, open Razorpay Settings → API Keys and generate a Live Key ID and Key Secret.

05

Open Print Settings

In the Shop Panel, open Print Settings and enable Online payment.

06

Save keys securely

Paste the Key ID, Key Secret and webhook secret. Do not share these credentials publicly.

07

Run a payment test

Scan the shop QR, upload a small document, pay online, and confirm that the paid job enters the print queue.

FAQ

Files, retries and support

Important answers for daily shop operation.

Where is a customer file stored?

The uploaded file stays in this server's shop upload folder while the job is waiting or retryable. After the shop confirms the job as Printed, the server copy is deleted.

What happens when printing fails?

The file is preserved so the shop can change the job back to Queued and retry it. This avoids forcing the customer to upload the same document again.

Why does a job show Picked instead of Printed?

Picked means the job was sent to the Windows printing process. The system intentionally waits for the shop to confirm Printed after paper comes out.

What should I check if the agent is offline?

Confirm MySQL and the website server are running, then start the Print Agent again. Verify its API URL, agent secret and exact Windows printer name.

Need help?

Open the Shop Panel and check the latest job status and agent message.

Shop Owner Login