API Command: upi_mandate_revoke
Cancel Recurring Registration API allows the merchants to cancel the UPI registration from their website. It is a mandate to implement the Cancel Recurring Registration API so that your customers can use Recurring Payments. After the registration is canceled for a customer, the merchant cannot restore it, and the customer must register a fresh mandate with the merchant (applicable for UPI).
Note:
Your customers cannot use Recurring Payments without the Cancel Recurring Registration API being implemented.
HTTP Method: POST
Request parameters
Variable | Description | Example |
---|---|---|
key mandatory |
| Your Test Key |
command |
| upi_mandate_revoke |
var1 |
|
|
hash | 512 SHA hash strings generated by encrypting request parameters so that any tampering can be avoided. | a6105d0e5c8726fd37713d02ace8f63 |
var1 JSON fields description
var1 parameter (JSON format) fields description:
Field | Description |
---|---|
authPayuId mandatory | This parameter must contain the mihpayid returned in the payment response of the Registration transaction when the transaction is successfully completed. |
requestId | This parameter must contain the unique request value generated at merchant’s end to distinguish independent request call. |
Response Parameters
Parameter Name | Description |
---|---|
status | Status defines acknowledgment from PayU. Possible values are: |
action | Always returned as “MANDATE_REVOKE” to highlight the type of action. |
message | Description of the Mandate cancellation process. |
Sample response
- Sample response for successful cancellation:
Cancelling Recurring Registration - Success Response
{
"status": 1,
"action": "MANDATE_REVOKE",
"message": "Request Initiated"
}
- Sample Response for failed cancellation
Cancelling Recurring Registration - Failure Response
{
"status": 0,
"action": "MANDATE_REVOKE",
"message": "Mandate is not active"
}