ENACH Mandate Registration Status

This API allows the platform to check the status of a mandate registration using Decentro's ENACH V3 stack.

Overview

Decentro allows the platform to check the status of mandate registration initiated through Registration API. This is in addition to the Registration Status Callback triggered by Decentro when the payer completes the registration authorization.

📘

Ensure to use only staging credentials.

Flow

Below is the flow for this API.

  • The payer is redirected from the link passed in the Registration API.
  • Decentro propagates the Decentro transaction ID as part of the response payload.
  • After the payer has authorized the request, Decentro triggers the Registration status callback and redirects the payer to the platform's page.
  • Alternatively, the platform can check the status using the Registration Status API by passing the Decentro transaction ID passed by Decentro in the response payload.

Decentro propagates the registration status as PENDING if the payer does not complete the authorization or the payer drops off in the journey.

Registration Statuses

StatusDescription
ActiveMandate registration has been successfully completed, and the mandate is currently active.
InactiveThe mandate registration end date has passed.
PendingMandate registration is still pending completion. The registration process has been initiated but has not been completed.
RejectedMandate is rejected by destination banks or NPCI for various reasons.
Registration_link_expiredThe mandate registration link has expired. This status occurs when the user fails to initiate or open the registration link within the specified timeframe.
Registration_session_timeoutThe user initiated the registration session by clicking on the registration link but did not complete the process. The registration was dropped mid-journey due to inactivity or other reasons.

API Endpoints

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

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