Once a Card Mandate registration is successful, you can seamlessly initiate the recurring debit transactions with Juspay at per the set frequency
Use the mandate_id (available from Order status API/ Webhooks) stored internally at your end and use Mandate Status API
to get the updated mandate status and confirm if the mandate is in active state before initiating the recurring debit flow.
Alternatively you can use the List Mandate API to fetch the mandate_ids linked for a particular customer_id.
Use Mandate Execution API to initiate the recurring debit transaction
Mandatory details: Order_id, Amount, Customer Id, Mandate ID
Please initiate this transaction at least 25 hours prior to the actual debit date to accommodate the time taken for a Pre-Debit Notification (PDN)
Once Mandate Execution transaction is received, Juspay immediately triggers a PDN.
Once this PDN is successful, there is a mandatory 24 wait period post which the recurring debit call is done by Juspay to the payment gateway
Please note that recurring debit transaction will be routed to the same PA/PG through which the Mandate registration was done
In case the PDN fails, a Notification_Failed webhook will be triggered from Juspay with the failure reason.
You can call the Mandate Execution API again to retry the recurring debit transaction
After the mandate execution is initiated, you can check the status of the Recurring debit transaction using Order Status API
Juspay will share the Card Mandate Recurring debit order status & details in response of Order Status API and also in Webhooks. Changes are required at your end to handle the mandate parameters passed in the responses
You can also use the List Mandate API to get the details of all the mandates for a particular customer for your Mandate Management section
You can manage the Juspay Mandate IDs set up for your users in Mandate Management section using the following APIs:
Use Revoke Mandate API to revoke/cancel an Active mandate
Use Pause Mandate API to Pause an Active Mandate till a set time
Use Resume Mandate API to resume the paused mandates
Have questions?
