Revoke UPI Mandate

PATCH

/api/v0/upi-mandate/revoke

📌

Use this API to revoke an active UPI mandate, stopping all future automated debits linked to that mandate. This helps you manage cancellations or customer opt-outs securely and efficiently.

Request

Header Params

merchantAccessKey

string

required

Authorization

string

required

Body Params application/json

remarks

string

required

Example

{
    "reference_id": "EN1234584",
    "amount": 1722,
    "description": "Sample Mandate Update Request"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/api/v0/upi-mandate/revoke' \
--header 'merchantAccessKey;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "EN1234584",
    "amount": 1722,
    "description": "Sample Mandate Update Request"
}'

Responses

🟢200OK

application/json

Body

umn

string

required

referenceId

string

required

mandateId

string

required

amount

integer

required

amountRule

string

required

currency

string

required

mcc

string

required

payer

object

required

name

string

required

vpa

string

required

account

string

required

accountValidation

boolean

required

name

string

required

expiry

string <date-time>

required

blockFund

boolean

required

recurrence

object

required

period

string

required

rule

string

required

value

integer

required

validity

object

required

startAt

string <date-time>

required

endAt

string <date-time>

required

pausePeriod

object

required

startAt

string <date-time>

required

endAt

string <date-time>

required

upiReferenceUrl

string

required

description

string

required

upiPurposeCode

string

required

upiResponseCode

string

required

status

string

required

createdOn

string <date-time>

required

Example

{
    "umn": "string",
    "referenceId": "string",
    "mandateId": "string",
    "amount": 0,
    "amountRule": "string",
    "currency": "string",
    "mcc": "string",
    "payer": {
        "name": "string",
        "vpa": "string",
        "account": "string",
        "accountValidation": true
    },
    "name": "string",
    "expiry": "2019-08-24T14:15:22Z",
    "blockFund": true,
    "recurrence": {
        "period": "string",
        "rule": "string",
        "value": 0
    },
    "validity": {
        "startAt": "2019-08-24T14:15:22Z",
        "endAt": "2019-08-24T14:15:22Z"
    },
    "pausePeriod": {
        "startAt": "2019-08-24T14:15:22Z",
        "endAt": "2019-08-24T14:15:22Z"
    },
    "upiReferenceUrl": "string",
    "description": "string",
    "upiPurposeCode": "string",
    "upiResponseCode": "string",
    "status": "string",
    "createdOn": "2019-08-24T14:15:22Z"
}

Modified at 2025-07-05 12:38:41

Update UPI Mandate

Get UPI Mandate