#Send a pre debit notification
PREREQUISITES
🌟 Create recurring mandate ↗Once the mandate is LIVE the merchant needs to send a pre debit notification 48 - 72 Hrs before debit / execution to let the customer be notified of the upcoming debit.
Merchant intervention is only needed for a pre debit notification if autoExecute and autoPreNotify are set to false while creating a mandate
The process for mandate pre debit notification is described in the below diagram:
The merchant will have to call the send mandate pre debit notification API with the correct set of parameters.
| Staging host | https://umap.setu.co/api |
|---|---|
| Method | POST |
| Path | /v1/merchants/mandates/{mandateId}/notify |
| Header | merchantIdAuthorization: Bearer <insert_token_here>. Generate this token using OAuth.Content-Type—will be application/json |
Sample request
{"amount": 1000,"executionDate": "04012006","merchantReferenceId": "ABC1234789","sequenceNumber": 1,"umn": "setumandate1234789@ybl"}
Request body parameter values for sending pre debit notification for a recurring mandate
| parameter | value |
|---|---|
| amount | must be as per the amountRule and maxAmountLimit configured while creating the mandate |
| executionDate | must be 48 - 72 Hrs ahead of current time |
| umn | can be derived from the notifications received by the merchant during mandate creation flow or via check mandate status API |
Sample response
{"amount": 1000,"createdAt": "2023-09-04T12:08:20+0530","executionDate": "04012006","id": "01ARZ3NDEKTSV4RRFFQ69G5FAV","mandateId": "01ARZ3NDEKTSV4RRFFQ69G5FAV","merchantId": "01ARZ3NDEKTSV4RRFFQ69G5FAV","merchantReferenceId": "ABC1234789","sequenceNumber": 1,"status": "pending","txnId": "BTTZrc5gDFkuCr3n3I0ey4aNtzLOLR7K7aR","umn": "c27f5fc30d344e9594fce0afa34f8859@mypsp"}
In the above response:
idis a unique ID that is associated with this mandate pre debit notification and can be used to track it later.
To know more about all the API params, please refer to the API documentation here.
UPI Setu will send notifications to the merchant for the following events:
- mandate_operation.notify.success (if mandate pre debit notification is successful)
- mandate_operation.notify.failed (if mandate pre debit notification fails)
Read more about mandate pre debit notification operation notifications here
In addition to the notifications, the merchant can also use check mandate pre debit notification status API to check if pre debit notification is successful
If autoExecute and autoPreNotify are set to true while creating a mandate, UPI Setu will schedule pre debit notifications and send notifications to the merchant for pre debit notification confirmation and mandate status in every recurrence cycle
Please refer to the Document Reference section for checking the API reference and the notifications.
#Check mandate pre debit notification status
In addition to the notifications sent by UPI Setu, Merchant can use this API to check the status of a mandate pre debit notification.
| Staging host | https://umap.setu.co/api |
|---|---|
| Method | GET |
| Path | /v1/merchants/mandate-pre-debit-notifications/{id} |
| Header | merchantIdAuthorization: Bearer <insert_token_here>. Generate this token using OAuth.Content-Type—will be application/json |
Sample response
{"amount": 1000,"createdAt": "2023-09-04T12:08:20+0530","executionDate": "04012006","id": "01ARZ3NDEKTSV4RRFFQ69G5FAV","mandateId": "01ARZ3NDEKTSV4RRFFQ69G5FAV","merchantId": "01ARZ3NDEKTSV4RRFFQ69G5FAV","merchantReferenceId": "ABC1234789","sequenceNumber": 1,"status": "success","txnId": "BTTZrc5gDFkuCr3n3I0ey4aNtzLOLR7K7aR","umn": "c27f5fc30d344e9594fce0afa34f8859@mypsp"}
idis a unique ID that is associated with this mandate pre debit notification and can be used to track it later.
To know more about all the API params, please refer to the API documentation here.