How to Add UPI QR Codes to Invoices and Collect Payments Safely

An invoice QR in DukaanAdda is a payment instruction. It turns selected invoice and business details into a UPI payment URI that a compatible app can read. The customer scans the code, reviews the receiver and amount, chooses a bank account and authorizes the payment inside their UPI app.

DukaanAdda does not move or settle the money. The customer authorizes the transfer through their UPI provider, and the funds go to the account attached to the UPI ID you configured. Selecting UPI as the payment mode in a bill is bookkeeping; it is not proof that the bank transfer succeeded.

Use a UPI ID controlled by the business owner or an authorized business account. Copy it from your trusted bank or merchant UPI app instead of relying on an old poster, message or screenshot. A single typing mistake can direct customers to the wrong receiver or make the QR unusable.

• Confirm the UPI ID character by character, including the handle after @.
• Check which bank account or merchant profile receives funds for that UPI ID.
• Make sure the displayed receiver name is recognizable to customers.
• Run a small controlled test from another trusted account before live billing.
• Verify the test credit from the receiving account, not only from the payer's screen.
• Restrict Payment Settings access to responsible staff.

DukaanAdda's form checks whether the text looks like a UPI ID: it expects one @, a valid-looking username and a recognized or common handle pattern. This validation catches many typing errors, but it cannot prove that the address exists, belongs to your business or is currently reachable. An unfamiliar legitimate handle may also need manual review.

1. 1

   Open Payment Settings

   Sign in with the correct business and open Settings, then choose Payment Settings. Saving this screen requires an internet connection.
2. 2

   Enter or scan the UPI ID

   Type the verified UPI ID manually. On the supported mobile flow, you can scan an existing UPI payment QR; DukaanAdda reads the payee address from a upi://pay QR and places it in the field. On Windows, use manual entry.
3. 3

   Review the extracted value

   A successful scan only extracts the payee address. It does not verify the bank account owner, receiver name or live reachability. Compare the result with your bank or merchant app before saving.
4. 4

   Add optional bank details

   Bank name, account number and IFSC can be stored as additional payment information. Keep them accurate, but remember that the invoice UPI QR itself is built from the UPI ID.
5. 5

   Save and run a test

   Save Payment Settings, create a low-risk test invoice and scan its QR using a different trusted device. Confirm the receiver, amount and final credit.

Camera scanning on Android or iOS needs camera permission. The scanner provides a torch and camera switch when supported. If permission is denied or the label is unclear, use manual entry rather than repeatedly scanning an uncertain code.

Open Settings, choose Invoice Settings and enable Show Barcode / QR Code. This preference controls whether the payment QR is displayed on supported invoice outputs. The default setting may already be enabled, but you should still inspect the final document.

If your invoice is already finalized, do not assume that changing the display preference or UPI ID will rewrite the stored QR data on that old bill. Test with a new invoice and audit any document you intend to resend.

DukaanAdda builds a standard UPI-style payment link beginning with upi://pay. The following fields are included in the current implementation:

NPCI's UPI FAQ explains that QR-based merchant integration can store merchant information such as the UPI ID and amount so the payer can review merchant information on the payment page. The payer should use that review screen: compare the displayed receiver and amount with the invoice before authorizing.

1. 1

   Create a low-value test bill

   Use a recognizable customer or internal test record and clearly label it so it cannot be mistaken for a live unpaid sale.
2. 2

   Review the invoice total

   Confirm item quantities, discount, tax, round-off and grand total before finalization. That grand total is the amount the QR will request.
3. 3

   Finalize and open the output

   Inspect the PDF and, if used at your counter, the thermal preview. Look for a readable QR and the expected payment label.
4. 4

   Scan from a separate trusted phone

   Confirm that the UPI app shows your intended receiver, the exact total and a recognizable invoice reference.
5. 5

   Verify a controlled payment

   If you make a small test payment, confirm its credit from the receiving bank or merchant app and retain the transaction reference for your setup record.

Repeat this check after changing the UPI ID, business name, invoice template, thermal printer settings or receipt width. A technically valid QR is useful only when it remains scannable and points to the right receiver.

Narrow paper, low print density, dirty print heads, faded rolls or aggressive scaling can reduce scan reliability. Print a test from the actual counter printer, scan it from normal customer distance and keep the UPI ID visible as a manual fallback when possible.

For printer connection, paper size and ESC/POS troubleshooting, follow the DukaanAdda thermal printer setup guide.

The current invoice payment QR uses the bill's full grand total. It does not recalculate its amount from the current due balance, payment status or the payment mode selected during billing.

The same caution applies to invoices marked Cash, fully paid bills and documents resent later: a QR can remain visible even though no UPI payment is currently due. Payment status and QR availability are separate concepts.

The most important counter rule is simple: a customer-facing success screen is not your settlement record. Before releasing goods or closing a high-value sale, check the receiving side.

1. 1

   Ask the customer to verify before paying

   Their UPI app should show the expected receiver name, invoice amount and payment purpose. If the receiver looks unfamiliar, stop and inspect your configured UPI ID.
2. 2

   Wait for the payer's final status

   Do not treat a loading, processing, pending or collect-request screen as success. Ask the payer not to repeat the transaction until the first attempt has a clear status.
3. 3

   Check your bank or merchant UPI app

   Verify the incoming credit in the receiving account you control. Match the amount and, when available, the transaction reference, payer details and time.
4. 4

   Record the payment accurately

   Only after verification should you mark the invoice paid or record the received amount and payment mode in DukaanAdda.
5. 5

   Keep an exception record

   For pending, reversed, duplicate or mismatched payments, note the invoice number and transaction reference. Resolve it through the bank or UPI app instead of creating an informal cash adjustment.

For customer credit controls, reminder etiquette and ledger review, use the Khata and Udhar management guide.

DukaanAdda can save QR payment data on the bill when the invoice is finalized. That stored data contains the payee address and original amount. When a PDF is rebuilt, existing bill QR data can be preferred over newly generated data.

• Record the date and reason for the UPI destination change.
• Run a controlled test on a newly created invoice.
• Scan recent old invoices to identify embedded legacy payment details.
• Replace printed counter signs and saved message templates.
• Tell staff which account is now authoritative.
• Keep the old receiving account monitored during a reasonable transition.

Train staff on one spoken confirmation: “Please check the shop name and amount before paying.” After the payer finishes, the staff member checks the merchant-side credit and says whether the payment is confirmed, pending or not received. This small script reduces both accidental wrong-payee payments and fake screenshot disputes.

Pair this routine with the fast billing counter workflow so speed never replaces the final amount and payment check.

A UPI QR also does not replace GST invoice requirements. For mandatory fields, tax calculation, HSN/SAC and compliance basics, read the complete GST invoicing guide.