Dynamic QR

This page gives you an overview of Decentro's dynamic QR capability.


A UPI QR code is a machine-scannable Quick Response (QR) code that contains the merchant's UPI details. To initiate a payment, a payer can scan the code using their UPI payment app (such as Gpay, PayTM, etc.). These codes must comply with NPCI’s UPI infrastructure requirements to ensure that the merchant's details are stored securely and that there are no errors during the payment journey.

Unlike static QR codes, dynamic QR codes are designed for one-time usage only for a single transaction. This ensures there are no reconciliation or experience issues for the platform or the payers. In addition, dynamic QR codes can be used for offline use cases like last-mile payments, online web-based payments, etc.


Decentro's payment link can be used to cater to multiple use cases.

  • Repayments: collect one-time repayments or downpayments from borrowers on your app which can be settled to the lender's account directly at a branch or in person.
  • Investments: collect one-time from your customers which can be settled to a clearing house or AMC for investment use-cases like Mutual funds, etc.
  • Deposits: collect one-time from your customers which can be settled to a bank partner for topping up fixed or recurring deposits.
  • E-commerce: collect from your customers at the point of delivery on your app and settle to your account or the seller if required.


  • Create a virtual account for a customer/partner/vendor with Decentro through APIs or from Decentro's dashboard.
  • Configure a Master virtual account for yourself. Please mail us at [email protected] for Decentro to configure this at its end.
  • Configure callbacks for account balance if you wish to see your ledger balance. Please mail us at [email protected] with the callback endpoints.
  • Configure callbacks for transaction status for transaction-level updates. Please email us at [email protected] with the callback endpoints.

v3 Workflow


Decentro has now released an upgraded workflow on its v3 stack which is designed for higher scale, better performance and experience. This can be found here : https://docs.decentro.tech/docs/payments-collections-v3#generate-dynamic-qr-code

v2 Workflow

Below is the flow if the platform leverages Decentro's intent flow/payment link capability.

  • The platform creates a dynamic QR code by passing the relevant payee account number using Generate UPI Payment Link API.
  • The platform can display the dynamic QR code on its app or website at checkout or on a third-party app.
  • The payer scans the QR code from the UPI app of their choice on their mobile.
  • The payer authorizes the transaction on the app by entering a valid PIN.
  • The platform receives a transaction status callback from Decentro to a pre-configured endpoint.
  • The platform receives an account balance callback from Decentro with the updated balance for successful transactions only against the passed ledger account number (payee account number).
  • The platform can also check the request status using the reference ID generated from the collection request using the Check Payment Status API.
  • The platform can also request a transaction refund using the Issue UPI Refund API, which will refund the original amount to the payer's account.

The platform can undertake the above activities on Decentro's dashboard, view the status of a payment link, and download the reports.

Decentro settles the funds collected on behalf of the platform to the registered bank account according to the agreed-upon timelines, which are shared at the time of onboarding.


Decentro uses Collections Response keys to handle different API and transaction-level scenarios. The platform can then use these to message the payer or end consumers for a seamless experience.

If you have any queries, please refer to the Collections FAQs page.