---
page_title: Overview
product: LotusPay
platform: Web
page_source: https://juspay.io/in/docs/lotuspay/web/mandate-management-apis/overview
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/lotuspay/llms.txt
---


# Overview



The merchant initiates an API request to **AMEND / PAUSE / RESUME / CANCEL**  a mandate. Once the request is received, the mandate status is updated to **Pending**  at LotusPay’s end.

The API response includes an **authentication (auth) link** , along with additional details such as the **link expiry time** . The customer must use this auth link to authenticate the request within the specified expiry period.

Simultaneously, a webhook is triggered to the merchant’s configured webhook URL with the event type `mandate.pending`, indicating that the request has been successfully created at LotusPay’s end.

If the customer’s authentication journey fails, the mandate is reverted to its previous state without any changes. Additionally, a webhook is sent to the merchant’s webhook URL with the event type `mandate.<ACTION>.failed` (_where_ `<ACTION>`_can be_ `amend`_,_ `pause`_,_ `resume`_, or_ `cancel`).

If the customer successfully completes the authentication journey, the requested action is applied to the mandate, and a webhook with the event type `mandate.<ACTION>.success` is sent to the merchant.

Optionally, while initiating the API request, merchants can also provide `return_url` and `auth_mode` within the redirect payload. After the authentication journey is completed, LotusPay will redirect the customer to the specified `return_url`. Additionally, the provided `auth_mode` will be used as the default authentication mode during the customer’s authentication journey.

**Note:** An authentication link can only be used once by the customer. If the authentication fails or the link expires, the merchant must initiate a **new request**  to generate a fresh authentication link.

---

## See Also

- [Types of events](https://juspay.io/in/docs/lotuspay/web/core-resources/types-of-events)
- [Amend API](https://juspay.io/in/docs/lotuspay/web/mandate-management-apis/amend-api)
