---
title: "Mandate Status Check"
method: POST
path: "/tsp/pg/api/mandate/statuscheck"
---

# Mandate Status Check

`POST /tsp/pg/api/mandate/statuscheck`

## Request body

- object
  - `merchantId` string, required — Merchant account ID. Size-12
  - `aggregatorId` string — Aggregator ID. Required if the original transaction was initiated from Aggregator. Size-12
  - `merchantTxnN` string, required — Transaction reference number. Same as original transaction number. Size-12
  - `secureHash` string — Hash Value. Size-64

## Response `200`

- object
  - `responseCode` string, required — Response code indicating success/failure of the transaction status request 000 / 0000 – Success P9506 - Mandate Expired (for this responseCode merchant needs to update the mandate status as MANDATE_EXPIED at merchant side. And no need to send Notification and Execute API onwards) Any other value indicates status request failure / original transaction not found. For status of the original txn always check errorCode and errorDescription Size-3
  - `respDescription` string, required — Description of failure. Ignore for Success response. Size-45
  - `merchantId` string, required — Merchant account ID. Echo of request field
  - `aggregatorID` string — Merchant Aggregator ID. Echo of request field
  - `merchantTxnNo` string, required — Merchant transaction reference number. Echo of request field
  - `errorCode` string — The reason code for failure 0000 - Success U1000 - Pending Anything Else is Rejected Size-255
  - `errorDescription` string — Description for failure. Size-255
  - `txnID` number — The unique reference number generated by the Payment Gateway. Only in case of Execute Mandate. Size-24
  - `paymentDateTime` number — Authorization date time. Only in case of Execute Mandate Format: YYYYMMDDHHMMSS Example: 2023111912121
  - `paymentID` number, required — The authorization/payment ID generated by the authorization system. Only in case of Execute Mandate. Size-24
  - `paymentSubInstType` string — The payment sub instrument type. Only in case of Execute Mandate. Size-64
  - `bankRRN` string, required — RRN received from the bank. Size-64
  - `requestType` string — Type of the request. Possible values: CREATE_MANDATE PAUSE_MANDATE REVOKE_MANDATE EXECUTE_MANDATE RESUME_MANDATE NOTIFICATION_MANDATE
  - `umn` string — Unique Mandate Number. If the mandate is created successfully, then it will be populated. Size-50
  - `upiQR` string — QR generated for mandate creation. If the QR is created successfully, then it will be populated. Size-512
  - `secureHash` string, required — Hash Value. Size-64
  - `mandateId` string — Unique Mandate ID. If the mandate is created successfully, then it will be populated. Size-50
  - `udFiedlds` string[] — Echo of request field

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/versions/55aa41b8482f/schema)