JIjiopay
PDN

PDN List

Paginated listing/search of PDN records.

post/subscription/pdn/list

Request

  • Base URL
    https://services.jiopay.co.in/api
  • URL
    https://services.jiopay.co.in/api/subscription/pdn/list
  • Auth
    HTTP bearer

Request body

pageinteger required

Page number.

limitinteger required

Page size.

statusstring

Filter, e.g. FAILED.

mandate_idinteger

Filter by mandate ID.

subscription_refidstring

Filter by subscription.

merchant_txn_nostring

Filter by merchant txn no.

from_datestring

Date range filter start (YYYY-MM-DD).

to_datestring

Date range filter end (YYYY-MM-DD).

searchstring

Free-text search.

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

{
  "page": 1,
  "limit": 10,
  "secureHash": "b6ade416a408311b519d34656f5894d627445d854e3011c8a3f8df8115123ae1"
}

Response

OK

successboolean
total_recordsinteger
current_pageinteger
total_pagesinteger

Example response

{
  "success": true,
  "total_records": 274,
  "current_page": 1,
  "total_pages": 28,
  "data": [
    {
      "id": 274,
      "mandate_id": 430,
      "amount": "10.00",
      "debit_date": "2026-03-07T19:42:26.000Z",
      "status": "CREATED",
      "phi_response_code": "0000",
      "phi_response_desc": "Transaction successful",
      "external_notification_id": "77MT000011336103",
      "subscription_refid": "SUBS11243112",
      "merchant_txn_no": "SUBS443378299",
      "created_at": "2026-02-27T04:55:37.000Z",
      "updated_at": "2026-02-27T04:55:38.000Z"
    }
  ]
}

Changes

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