---
title: "Execute Mandate"
method: POST
path: "/pg/api/mandate/execute"
---

# Execute Mandate

`POST /pg/api/mandate/execute`

API to debit on existing mandates with Cards or UPI

## Request body

- object
  - `merchantId` string, required — Merchant account ID
  - `merchantTxnNo` string, required — Unique ref no to identify the request. Should have only alphanumeric characters. No other characters allowed.
  - `amount` string, required — Transaction amount, 9 significant and 2 decimal/precision. As sent in PDN request.
  - `currencyCode` string, required — Transaction Currency
  - `remark` string — Remarks.
  - `aggregatorID` string — Merchant Aggregator ID
  - `mandateId` string, required — Mandate id as returned in create mandate flow
  - `purpose` string — Possible value `RECURRING` or `OT`
  - `txnId` string — txnId as received in successful PDN call for execute
  - `billNumber` string — billNumber as used during create api
  - `secureHash` string, required — Hash value

## Response `200`

Successful response

- object
  - `responseCode` string — Response code indicating success/failure. R1000 – Request Initiated successfully Any other value indicates failure
  - `responseDescription` string — Description of failure. Ignore for success response.
  - `merchantId` string — Merchant account ID
  - `aggregatorID` string — Merchant aggregator ID
  - `merchantTxnNo` string — Merchant Txn ref Number
  - `redirectURI` string — Redirection URL. Will be available in case merchant is required to redirect to complete payment authorization. Either this field or showOTPCaptureP age field will be available in response.
  - `generateOTPURI` string — generateOTP . Will be available when showOTPCaptureP age is ’Y’
  - `verifyOTPURI` string — verifyOTPURI, Will be available when showOTPCaptureP age is ’Y’
  - `authorizeURI` string — authorizeURL, Will be available when showOTPCaptureP age is ’Y’
  - `showOTPCapturePage` string — Show OTP Page indicator, `Y` / `N`. Y – Merchant should display a page to ask for OTP. Please do contact integration team for OTP capture page requirements
  - `tranCtx` string — The transaction context generated by the PG, Needs to be sent as is to the redirectURI / authorizeURI endpoint
  - `secureHash` string — Hash value

## Other responses

- `4XX` — Client Error

---

[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)