post https://your.custom.endpoint.com/upi_registration_status
This callback is triggered by Decentro to the platform when the customer approves the mandate request on the PSP app.
Overview
Decentro triggers this callback to a pre-configured endpoint after the payer authorizes the mandate registration request on their UPI app or if the registration expires.
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 initiates the mandate registration request using the Create Mandate API.
- The payer authorizes the request on the UPI app using their MPIN.
- Decentro triggers this callback to the platform's endpoint as configured with the registration status if authorized.
- The platform can reconcile the registration request using the reference_id or decentro_mandate_id parameters passed in the Create Mandate API.
- The platform can also check the registration status using the Get Mandate Status API.
Decentro triggers the callback for the below scenarios.
- Successful registration of a mandate
- Unsuccessful registration of a mandate
- Expiry of the mandate request
- Pause, unpause, revoke or update actions on a mandate
- Completion of the mandate
Mandate Status
| Status | Description |
|---|---|
| Active | Mandate is successfully registered & in active state. These mandates can be used for presentations. |
| Revoked | Mandate is revoked/ cancelled. These mandates are not eligible for presentations. (Not in use) |
| Pending | Mandate registration link is created & no action is performed on the link yet. |
| Expired | Mandate registration link is expired. No action is performed on the link by the user. |
| Completed | When mandate end date is passed or all scheduled presentations are completed. No further presentations allowed. |
| Rejected | When mandate registration is failed. |
| Paused | Mandate is paused by the end user. No presentations allowed during paused state. |
| Failed | When mandate registration is failed. |
| Cancelled | Mandate is revoked/ cancelled. These mandates are not eligible for presentations. |
API Endpoints
| Environment | Endpoint |
|---|---|
| Staging / Sandbox | https://your.custom.endpoint.com |
| Production | https://your.custom.endpoint.com |