🙌

Important Note

Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.

Overview

This API empowers platforms to authenticate the bank account information of their customers by leveraging Decentro's Penny Pull/Reverse Penny Drop stack capability through the intent flow where the payer doesn't have to enter a VPA (UPI ID).

Flow

Below is the flow for using the Penny pull intent link/intent flow through Decentro.

1. The platform creates a penny pull intent link using this API.
   1. The platform can use the shortened link directly on a web/app flow or use individual deep links by passing generate_psp_uri as true.
2. Decentro relays the status of the link creation using response keys and the Decentro transaction ID, which can be used to check the status through the Get Transaction Status API or map the same from the callback triggered by Decentro to the platform.
3. The platform sends the shortened link directly to the end customer via SMS, WhatsApp, etc., or can embed it on its web/app.
4. The payer clicks on the link and authenticates the payment by entering their UPI MPIN on the app of their choice.
5. Decentro triggers the Terminal Transaction Status Callback to the client's pre-configured endpoint with the transaction status.
6. Alternatively, the platform can check the status of the Intent link using the Get Transaction Status API, which can be done using Decentro's transaction ID, which is available as the response in this API.
7. The payer gets a refund of their INR 1 transaction if successful within 3 working days of the transaction being completed.

Key Points

Below are the key points about the intent link workflow.

• If the payer uses the link to land on a UPI app within the expiry time of 60 minutes, the payer should be able to complete the transaction, unless you define a custom expiry period.
• If the payer uses the link to land on a UPI app after the expiry time, the payer will not be able to complete the transaction.
• If the payer clicks on the link after expiry, the payer will not be redirected to any UPI app, or shown the UPI QR code. Instead the link will be marked as expired and the same will be shown to the payer on the landing page.

API Endpoints

Below are the API endpoints to be used by the platform basis the environments.

Simulation Data

Below is the test data that can be used by platforms to test out standard scenarios for this API.
The platform is expected to pass the parameters as-is to get the intended scenario.

📘

Note - Simulation Data

To test Simulation Staging data for Penny Pull - Intent API, please use the following API Endpoint: https://staging.api.decentro.tech/v3/payments/rpd/intent

Steps to use this data:

1. In the request body, pass request values as shared below in the table, depending on the scenario to be tested.
2. Trigger the Create Intent API with the choice(s) chosen in Step 1.
3. Based on the values provided in Step 1 for each request parameter, the API response will confirm the creation of a short link, QR code, and PSP-specific deep links.
4. In the API response, locate the field labeled decentro_txn_id and make a note of it. This decentro_txn_id will be utilised to retrieve the transaction status using the Get Transaction Status API, indicating whether the payer has completed the payment or not.

Response Parameters

Below are the parameters propagated by Decentro in the response.

Response Keys

Below are the response keys propagated by Decentro in the responseKey parameter, which cover all the scenarios a platform can encounter.

Please note that the below keys don't include transaction-related response keys since the transaction status is relayed only after the payer authorizes payment.