Notify & Execute Mandate
Purpose : Use the Notify & Execute Mandate API to notify the customer about an upcoming debit against an existing UPI mandate. This API sends the mandate debit notification and automatically debits the amount on the specified execution date and time.
Possible values for paymentMode : upiCollectMandate, upiIntentMandate, upiQrMandate
Request Type : POST
Endpoint : /transactU?v=12
This API flow is only for Adhoc frequency mandates. Use it when you need to notify the customer for an execution linked to an existing mandate parent order ID.
Request Attributes
These are the Request Attributes of the Notify & Execute Mandate API.
Response Attributes
These are the Response Attributes of the Notify & Execute Mandate API
Note - Set executionDate at least 24 hours from the notification request time. Zaakpay notifies the customer and automatically debits the amount on the scheduled execution date and time.
Sample Request & Response
For reference, below are the sample CURL request and Response of API . It takes all required attributes to hit the Mandate API.
Sample Request
We have created a sample request of Notify & Execute Mandate API with all required attributes and their values, in the order in which they’ll be sent to the API.
The resulting checksum calculated should be posted to the Zaakpay API along with other required attributes.
curl --location 'https://api.zaakpay.com/transactU?v=12' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: JSESSIONID=CD982B57935E84BA7D70996C618C0C69.11.52; JSESSIONID=AE2704BE6746B7DC1B99CB4C7F9E9A06.11.36; JSESSIONID=AE2704BE6746B7DC1B99CB4C7F9E9A06.11.36; JSESSIONID=69CCAE16E0983DC36355B6307ACD196C.11.59; JSESSIONID=7905AC8D5DDC76EEFA667222571B4B19.162.243; JSESSIONID=3B6EBC278784D2FE8CA2BC1A3C3A8A2E.163.230' \
--data-urlencode 'data={"merchantIdentifier":"b19e8f*********647973","encryptionKeyId": "xf8******bfq","merchantIpAddress":"127.0.0.1","showMobile":"true","mode":"0","returnUrl":"https://webhook.site/04087ce3-beb0-4ade-991b-8a60c8651307","orderDetail":{"orderId":"Zaak*****234","amount":"1000","currency":"INR","purpose":"1","productDescription":"Upi P2m Collect","email":"[email protected]","txnDate":"2026-02-07"},"billingAddress":{"first name":"Test_FirName","last name":"Test_LasName","address":"sector 56","city":"Gurugram","state":"Haryana","country":"India","pincode":"122003","Phone Number":"9999999999"},"shippingAddress":{"address":"sector 54","city":"Gurugram","state":"Haryana","country":"India","pincode":"122003"},"paymentInstrument":{ "paymentMode": "upiCollectMandate", "upiMandate": { "action": "notify", "mandateParentOrderId": "Zaa*****1234", "executionDate": "2026-05-28 16:00:00" } },"debitorcredit":"upi"}' \
--data-urlencode 'checksum=3053622d*************a93bb0d98bb73ed8f'Sample Request
{
"merchantIdentifier": "b19e8***********6b7973",
"encryptionKeyId": "xf********bfq",
"merchantIpAddress": "127.0.0.1",
"showMobile": "true",
"mode": "0",
"returnUrl": "https://webhook.site/04087ce3-beb0-4ade-991b-8a60c8651307",
"orderDetail": {
"orderId": "Zaa&******234",
"amount": "1000",
"currency": "INR",
"purpose": "1",
"productDescription": "Upi P2m Collect",
"email": "[email protected]",
"txnDate": "2026-02-07"
},
"billingAddress": {
"first name": "Test_FirName",
"last name": "Test_LasName",
"address": "sector 56",
"city": "Gurugram",
"state": "Haryana",
"country": "India",
"pincode": "122003",
"Phone Number": "9999999999"
},
"shippingAddress": {
"address": "sector 54",
"city": "Gurugram",
"state": "Haryana",
"country": "India",
"pincode": "122003"
},
"paymentInstrument": {
"paymentMode": "upiCollectMandate",
"upiMandate": {
"action": "notify",
"mandateParentOrderId": "Zaa*******1234",
"executionDate": "2026-05-28 16:00:00"
}
},
"debitorcredit": "upi"
}Sample Response
The Response will be in JSON Format
{
"orderDetail": {
"orderId": "Zaa******234",
"amount": "1000",
"currency": "INR",
"productDescription": "Upi P2m Collect",
"email": "[email protected]",
"txnDate": "2026-02-07",
"purpose": "1",
"amountBreakdown": {}
},
"responseCode": "1109",
"responseDescription": "UPI Mandate notification sent successfully",
"doRedirect": "true",
"paymentInstrument": {
"paymentMode": "UPI_MANDATE",
"sendOtp": false,
"upiMandate": {
"action": "notify",
"mandateParentOrderId": "Zaa******234",
"executionDate": "2026-05-28 16:00:00"
}
},
"bankPostData": {
"amount": "1000",
"initDateTime": "2026-05-27 15:45:32"
},
"paymentMode": "UPI_MANDATE"
}Checksum Calculation
Create a string(JSON) using the request attributes as given below. Checksum string will create based on the request attributes which are posted to Zaakpay as same as given in the string below.
Now, Calculate the checksum using the HMAC SHA-256 algorithm using the string as data and your generated secret key. The resulting checksum calculated should be posted to the Zaakpay API along with other data.
{"merchantIdentifier":"b19e8f103bce406cbd3476431b6b7973","encryptionKeyId": "xf8utxlDZA76bfq","merchantIpAddress":"127.0.0.1","showMobile":"true","mode":"0","returnUrl":"https://webhook.site/04087ce3-beb0-4ade-991b-8a60c8651307","orderDetail":{"orderId":"Zaakstg1234","amount":"1000","currency":"INR","purpose":"1","productDescription":"Upi P2m Collect","email":"[email protected]","txnDate":"2026-02-07"},"billingAddress":{"first name":"Test_FirName","last name":"Test_LasName","address":"sector 56","city":"Gurugram","state":"Haryana","country":"India","pincode":"122003","Phone Number":"9999999999"},"shippingAddress":{"address":"sector 54","city":"Gurugram","state":"Haryana","country":"India","pincode":"122003"},"paymentInstrument":{ "paymentMode": "upiCollectMandate", "upiMandate": { "action": "notify", "mandateParentOrderId": "Zaakstagg1234", "executionDate": "2026-05-28 16:00:00" } },"debitorcredit":"upi"}3053622dcba2fea53871895b6e8780aff76f5864a95557b4c3bb0d98bb73ed8fUpdated 2 days ago