Mandate

Mandate Status

Polls the status of a mandate, PDN, execution, or refund request.

Auth note (from source): documented as no-auth in the source collection — "verify with backend team; likely still requires bearer in production." This uncertainty is from the source itself, not confirmed.

post/subscription/mandateStatus

Request

Base URL
https://services.jiopay.co.in/api
URL
https://services.jiopay.co.in/api/subscription/mandateStatus
Auth
none required

Headers

x-seamless'0' | '1'

1 for seamless/API-driven flow, 0 for redirect flow.

Request body

client_idstring required

Merchant/client identifier.

subscription_refidstring required

Subscription reference to query.

merchant_txn_nostring

Required for PDN, EXECUTE, REFUND lookups.

refund_merchant_txn_nostring

Required when request_type = REFUND.

request_type'MANDATE' | 'PDN' | 'EXECUTE' | 'REFUND' required

secureHashstring

HMAC-SHA256 signature, computed client-side before sending and validated server-side (auto-generated by the caller, not a value you choose). Algorithm: remove any existing secureHash, sort the remaining top-level keys alphabetically, join String(value).trim() per key with |, then HMAC-SHA256 the resulting string with your client_secret, hex-encoded. A second variant used by some endpoints strips comments from the raw body first and JSON-stringifies object values instead of String()-converting them — confirm which variant applies with the JPSL integration team before implementing.

Example request

{
  "client_id": "11182576a878438aa94ef7bee1507764f08d74131e41dc75",
  "subscription_refid": "SUBS11243112",
  "merchant_txn_no": "SUBS11243112_1770786395706",
  "secureHash": "b6ade416a408311b519d34656f5894d627445d854e3011c8a3f8df8115123ae1"
}

Response

statusCodeinteger

statusDescstring

Example response

{
  "statusCode": 200,
  "statusDesc": "Success",
  "response": {
    "merchant_id": "JP2000000000030",
    "amount": "1000.00",
    "currency": "356",
    "customer_id": "CUST_10010",
    "customer_name": "John Doe",
    "customer_mobile": "9876543210",
    "customer_email": "test@jiopay.in",
    "subscription_refid": "SUBS11243112",
    "status": "ACTIVE",
    "start_date": "2026-02-11T00:00:00.000Z",
    "end_date": "2027-06-01T00:00:00.000Z",
    "frequency": "AS",
    "umn": "MA1E9F00718631",
    "errorDescription": "Transaction successful",
    "errorCode": "0000",
    "responseCode": "0000",
    "merchantId": "JP2000000000030",
    "merchantTxnNo": "SUBS11243112_1770786395706",
    "mandateId": "MA1E9F00718631",
    "paymentDateTime": "20260211103744",
    "txnID": "77MT000008460707",
    "authCode": "ABC123",
    "requestType": "CREATE_MANDATE",
    "paymentMode": "Card",
    "respDescription": "Transaction successful",
    "authAmount": "10.00",
    "paymentInstID": "XXXX XXXX XXXX 0005",
    "udfFields": {
      "udf21": "xd"
    },
    "paymentSubInstType": "DC",
    "paymentID": "UHM31ZD002JRY8",
    "bankRRN": "UHM31ZD002JRY8"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.