Payment link

Overview

This collection of APIs enables you to collect money via UPI (Unified Payments Interface) from your customers or enable your partner businesses/SMEs to do the same. We support multiple methods, such as Dynamic UPI QR codes, payment links, or app-specific deep links.

Decentro's payment link allows the payer complete flexibility regarding the payment experience, which could be through any UPI app on their device.

This is compared to a collect request, which will be triggered directly to the payer's UPI handle on the app of their choice, which might not necessarily be installed on their device.

Decentro provides UPI intent capabilities through its APIs, dashboards, or SDKs, which can be embedded in a website or mobile app.

Usecases

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.
• 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 for shopping online on your app and settle to your account or the seller if required.

📘

Collections SDKs

Decentro has now released UPI collection SDKs that support multiple languages like React.js, React and Android that platforms can use to embed payment flows on their app/site without the effort of end-to-end integration. Please contact us at [email protected] if you are an existing customer of Decentro or signup here for quick access!

UPI Payment Link Variants

Decentro supports multiple types of payment links.

• Generic UPI Link: The platform can use a vanilla payment link, which the payer can pay from any UPI app. If found, this typically opens up all the UPI apps available on the mobile, and the customer can choose the app to pay from.
• UPI Deep-Links: This is a variation of the payment link where Decentro provides protocols (deep links) for popular PSP apps, and if the platform embeds the same on their app, the payer can pay from the specific app only, and the payer is redirected back after completing the action on the UPI app.
• Shortended Link: This is an add-on feature provided by Decentro. The payer can open a page hosted by Decentro and pay using any specific UPI app embedded. This typically works the same on Android or iOS devices, and the payer can pay using any UPI app.
• SDKs: This capability allows a platform to embed SDKs in popular languages like React.js, Android, and React Native on their app, website, or any other asset. Decentro handles the entire payer experience from the point the SDK is triggered. Read more about it here.

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-upi-payment-link

v2 Workflow

Pre-requisites

• 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 balance if you wish to see your ledger balance. Please mail us at [email protected] with the callback endpoints.
• Configure callbacks for transaction for transaction-level updates. Please email us at [email protected] with the callback endpoints.

Flow

Below is the flow if the platform is leveraging Decentro's intent flow/payment link capability using Decentro's Collections v2 suite of APIs.

• The platform creates a payment link by passing the relevant payee account number as mentioned here
• The platform can display deep links or shortened ones on their app.
• The payer clicks on the link and is redirected to 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 on 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 by 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.

Integration

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

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