Get Mandate Execution Status

This API is used to get the status of a mandate presentation.

Overview

This API can be used to check the status of a mandate execution initiated by the Execute Mandate API as an alternative to the Execution Callback to fetch the details of a execution.

Flow

Below is the flow for using this API.

  • The platform presents the mandate using the Execute Mandate API and receives the transaction ID from Decentro.
  • Decentro presents the same to its bank partner and the funds might be debited from the payer's bank account mapped to the VPA against which the mandate is registered.
  • Decentro triggers the Execution Status callback to the configured endpoints of the platform as soon as a terminal status (Success/Failure) is received
  • The platform can alternatively check the satus of the debit using the the endpoints of this API using the Decentro transaction ID from Execute Mandate API.

Points to Note

  • If this API is used before the status of the execution reaches the terminal stage, Decentro returns the status of the mandate as 'Pending'
  • If this API is used after the status of the execution reaches the terminal stage, Decentro returns the status of the mandate execution as 'Success' or 'Failure' depending on the transaction status
  • If the execution itself doesn't happen for any reason, Decentro returns the status of the mandate execution as 'Failure'

API Endpoints

Below is the endpoints for using this API.

Language
Click Try It! to start a request and see the response here!