UPI Mandate Callback

POST

/post

📌

EnKash sends a callback (webhook) to your server whenever there’s an update to a UPI mandate—such as approval, rejection, or revocation. Use this to automatically track mandate status changes and keep your systems in sync without manual checks.

Request

Body Params application/json

Example

{
    "umn": "XYZ987",
    "referenceId": "TXN6543210",
    "mandateTransactionId": "ENKA00001234",
    "amount": 1722,
    "amountRule": "EXACT | MAX",
    "currency": "usd",
    "payee": {
        "vpa": "merchant@abc",
        "name": "ABC Pvt. Ltd.",
        "mcc": "1234"
    },
    "payer": {
        "name": "Jane Smith",
        "vpa": "1234567890.prod@bank",
        "account": "5678901234",
        "accountValidation": true
    },
    "name": "Subscription Payment",
    "expireAt": 1823418099,
    "blockFund": true,
    "revokeableByPayer": true,
    "recurrence": {
        "period": "ONE_TIME | DAILY | WEEKLY | FORTNIGHTLY | MONTHLY | BIMONTHLY | QUARTERLY | HALF_YEARLY | YEARLY | AS_PRESENTED",
        "rule": "after",
        "value": 3
    },
    "validity": {
        "startAt": 1823418099,
        "endAt": 1924519100
    },
    "pausePeriod": {
        "start_at": 1722317078,
        "end_at": 1722317078
    },
    "upiReferenceUrl": "https://www.example.com/",
    "description": "Automated Recurring Mandate",
    "upiPurposeCode": "10",
    "upiResponseCode": "99",
    "status": "pending",
    "createdAt": 1823418099
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/post' \
--header 'Content-Type: application/json' \
--data-raw '{
    "umn": "XYZ987",
    "referenceId": "TXN6543210",
    "mandateTransactionId": "ENKA00001234",
    "amount": 1722,
    "amountRule": "EXACT | MAX",
    "currency": "usd",
    "payee": {
        "vpa": "merchant@abc",
        "name": "ABC Pvt. Ltd.",
        "mcc": "1234"
    },
    "payer": {
        "name": "Jane Smith",
        "vpa": "1234567890.prod@bank",
        "account": "5678901234",
        "accountValidation": true
    },
    "name": "Subscription Payment",
    "expireAt": 1823418099,
    "blockFund": true,
    "revokeableByPayer": true,
    "recurrence": {
        "period": "ONE_TIME | DAILY | WEEKLY | FORTNIGHTLY | MONTHLY | BIMONTHLY | QUARTERLY | HALF_YEARLY | YEARLY | AS_PRESENTED",
        "rule": "after",
        "value": 3
    },
    "validity": {
        "startAt": 1823418099,
        "endAt": 1924519100
    },
    "pausePeriod": {
        "start_at": 1722317078,
        "end_at": 1722317078
    },
    "upiReferenceUrl": "https://www.example.com/",
    "description": "Automated Recurring Mandate",
    "upiPurposeCode": "10",
    "upiResponseCode": "99",
    "status": "pending",
    "createdAt": 1823418099
}'

Responses

🟢200OK

application/json

Body

Example

{}

Modified at 2025-07-05 12:40:18

Get UPI Mandate

Mandate Pre-debit Notification