JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Mandate Execution
(Auto debit of Subscription)

After successful mandate registration, the next step is auto debit of the subscription for next renewal cycle. You need to call the Mandate Execute API at least 25 hours before the auto debit date. Post that, bank will notify the user about the debit via SMS. Follow the steps mentioned below to integrate Mandate Execution successfully.

Step 2.0.

Updated Mandate Status

This is an optional but recommended step. It’s always better to know the status of the Mandate before calling the Execution API, to avoid calling revoked or expired mandates. There are multiple ways to know the mandate Status

Consume Mandate Status Webhooks
Use Mandate Status Check API - This API can be called to get the status of a particular mandate setup with us; we will sync with PGs to get the latest Mandate Status value and update back in our response, or share the latest Mandate Status stored with us in DB.
Use List Mandate API - This API can be called to get the list of all the mandates that a customer has with them. The list will have the revoked, expired and failed mandates too.

Step 2.1.

Call Mandate Execution API

Call Mandate Execution API (Server to Server call) to initiate a recurring debit transaction.
After the successful Mandate registration, Merchant will receive a mandate_id, mandate_token from Juspay that should be stored against a customer at their end. For the subsequent charge transactions, this API need to be called which will create an order and perform a transaction with PG based on the mandate_id passed in the request.

Call this API atleast 25 hrs. prior to the execution date. Always use a unique new order_id for the recurring payment in this API.

Step 2.2.

Consume Notification Webhooks

Once the Execution API is successfully hit, Juspay will initiate the transaction with the underlying PG. Subsequently, the bank will notify the user of the debit via SMS. To track the notification status, you need to consume the Notification Webhook.

If the notification is successful, Juspay will trigger a Notification Success webhook, and the amount will be debited from the user's account accordingly.

However, if the notification fails, Juspay will initiate a Notification Failure webhook. In this scenario, the Mandate Execution API must be re-initiated.

Check out the Flow Diagram to know in detail about handling the Notification webhook.

Till the notification and execution takes place, transaction status will be Pending. According to RBI, notification will be triggered for cards and UPI only.

Step 2.3.

Handle Mandate Execution Response

Mandate Execution(Auto debit of Subscription)

Mandate Execution
(Auto debit of Subscription)