Package Information
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:
- Google Sheets Trigger (new row with
upi_id,customer,amount,invoice_no). - Pro UPI QR → UPI → Generate QR Code. UPI ID
{{ $json.upi_id }}, Payee NameYour Shop, Additional Fields → Amount{{ $json.amount }}, NoteInvoice {{ $json.invoice_no }}. - 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
- Pro UPI QR tools API docs and OpenAPI spec
- n8n community nodes documentation
- Support: support@proupiqr.in