proupiqr

n8n community node for Pro UPI QR: build UPI payment links and QR codes, check UPI links, explain UPI error codes, and calculate GST, MSMED interest, UPI MDR and rupee amounts in words. It never moves money.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: Kunal Siyag

Documentation

n8n-nodes-proupiqr

An n8n community node for Pro UPI QR: free tools for payments in India.

It builds UPI payment links and QR codes, checks UPI links, explains UPI error codes, and calculates GST, MSMED Act late-payment interest, UPI MDR and rupee amounts in words.

It never moves money. It only builds links and QR codes and does calculations. The payer approves every payment in their own UPI app. Nothing you send is stored.

Installation · Operations · Credentials · Output · Example workflow · Limits and errors · Compatibility · Resources

Installation

Follow the community nodes installation guide. In n8n: Settings → Community Nodes → Install, enter n8n-nodes-proupiqr.

Operations

Resource Operation What it does
UPI Create Payment Link Builds a upi://pay link that opens PhonePe, Google Pay, Paytm, BHIM or any UPI app with the payee, amount and note filled in, plus a proupiqr.in page with its QR code and a printable poster.
UPI Generate QR Code Generates a UPI payment QR code as a PNG file (binary property data, file name qr.png), plus the link.
UPI Check Link Reads a upi://pay link (the text inside a payment QR code): who gets paid, the amount, the note, and warnings about anything malformed or risky, such as an AutoPay mandate posing as a payment.
UPI Explain Error Explains a failed UPI payment from its code or message (U30, ZM, XH, Z9, U16, ...): what it means, which side caused it, whether money was debited and what to do next.
Calculator GST Adds GST to a price or takes it out of a GST-inclusive price, split into CGST + SGST (within a state) or IGST (between states).
Calculator MSMED Interest Interest a buyer owes a micro or small enterprise for paying late under Section 16 of the MSMED Act (three times the RBI Bank Rate, compounded monthly).
Calculator UPI MDR The UPI merchant discount rate on one payment under the rules from 15 October 2026, the 18% GST on it and what the merchant keeps.
Calculator Amount in Words A rupee amount in words the Indian way (lakh and crore), as on invoices and cheques.
Tool Catalog Find Tools Finds the free Pro UPI QR browser tool for a task (invoices, rent receipts, GST tools, QR posters...).

Amounts are typed in rupees (499, 1250.50, at most two decimals). Dates are YYYY-MM-DD. The node can also be used as a tool by n8n AI agents.

Credentials

None. The Pro UPI QR tools API is free and needs no key or account.

Output

Each item's JSON is the API's data object plus text, a readable summary with links to the matching free tool. Money is always in integer paise (*_paise), so amount_paise: 49900 is ₹499.00.

Example (Calculator → GST, ₹12,000 at 18% within a state):

{
  "taxable_paise": 1200000,
  "cgst_paise": 108000,
  "sgst_paise": 108000,
  "igst_paise": 0,
  "gst_paise": 216000,
  "total_paise": 1416000,
  "rate_percent": 18,
  "text": "₹12,000.00 plus 18% GST, within a state: ..."
}

Generate QR Code also attaches the PNG as binary data (property data by default, file name qr.png, image/png), ready for Gmail, Telegram, WhatsApp Business, Google Drive or Write Binary File nodes.

Example workflow

Send every new invoice a UPI QR code:

  1. Google Sheets Trigger (new row with upi_id, customer, amount, invoice_no).
  2. Pro UPI QR → UPI → Generate QR Code. UPI ID {{ $json.upi_id }}, Payee Name Your Shop, Additional Fields → Amount {{ $json.amount }}, Note Invoice {{ $json.invoice_no }}.
  3. Gmail → Send, attachment from binary property data, body {{ $json.text }}.

Other ideas: explain the error code from a failed-payment webhook and post it to Slack; compute GST for each order row before writing it to your accounting sheet; turn invoice totals into words for a PDF.

Limits and errors

  • 120 calls a minute per network address. A 429 stops the node with a rate-limit message; add a Wait node or batch your items.
  • If an argument needs fixing (HTTP 422, for example an amount with three decimals or a malformed UPI ID), the node fails with the API's message, such as amount must be rupees above zero with at most two decimals, e.g. 1000 or 2499.50. With Continue On Fail the item is returned as { "error": "<message>" } instead.

Compatibility

Built with @n8n/node-cli 0.55 (n8n nodes API version 1). Tested with n8n-workflow 2.x. No runtime dependencies.

Development

npm ci --ignore-scripts   # a transitive dev dependency runs `npx only-allow pnpm` on install
npm run lint
npm test                  # builds, then runs the node with a mocked n8n context
PROUPIQR_TEST_BASE_URL=http://127.0.0.1:4545 node --test test/*.test.cjs   # against a local server
npm run dev               # n8n with the node loaded (needs Docker or Podman, or --external-n8n)

Publishing happens from GitHub Actions with npm provenance; see .github/workflows/publish-n8n-node.yml at the repository root.

Resources

License

MIT

Discussion