UPI Autopay - Pre-Debit Notification Callback

post

https://your.custom.endpoint.com/upi_pdn_status

This callback is triggered by Decentro to the platform when a debit request is executed

Overview

Decentro triggers this callback to a pre-configured endpoint after a PDN is executed using the Pre-debit Notiifaction API The status of the PDN itself could be success or failure.

The platform can have the callback endpoints whitelisted by dropping a mail to [email protected].

Flow

Below is the flow for using this callback.

The platform triggers the PDN using the Pre-debit Notification API
Decentro triggers this callback to the configured endpoints of the platform as soon as a terminal status (Success/Failure) is received
The platform can alternatively check the status of the PDN using the Get Pre-debit Notification Status API.

Decentro triggers the callback for the below scenarios.

Successful PDN
Failure PDN

API Endpoints

Below are the API endpoints that can be configured by Decentro for receiving the callbacks.

Environment	Endpoint
Staging / Sandbox	https://your.custom.endpoint.com
Production	https://your.custom.endpoint.com

Body Params

presentation_sequence_id

string

The presentation sequence ID of the presentation cycle

decentro_txn_id

string

The decentro Txn ID of the presentation

callback_attempt

int32

The number of times the callback is attempted

callback_txn_id

string

Callback ID provided by Decentro

consumer_urn

string

The URN of the entity against which the mandate was registered.

callback_timestamp

string

The timestamp of the callback

original_callback_txn_id

string

Original Callback ID. Shared in case of retries only

reference_id

string

The reference ID passed by the platform at the time of Presentation API. For instant presentations, Reference ID will be mapped to Create Mandate APIs reference_id

decentro_mandate_id

string

Unique decentro mandate ID assigned for each mandate.

amount

double

Mandate registration amount

error_key

string

Presentation failure reason bucketing.

error_key_description

string

NPCI error code & reason for failure

status_description

string

Status description of PDN request

notification_status

string

Status of the PDN

Headers

your_custom_header_key_1

string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

your_custom_header_key_2

string

The header token shared by you should not contain any unsanitized values like @ # $ % ^ & * ! ; : ' " ~ ` ? = + ) (

Response

Overview

Flow

API Endpoints

200200