JIjiopay
Execute

Refund

Initiates a refund against a mandate or a specific presentation/execution. Supports bulk submission via a refunds array.

statusCode: 900 at the batch level indicates a mixed/failed batch — always inspect results[] for per-item outcomes.

Auth note (from source): documented as no-auth in the source collection.

post/subscription/mandate/refund

Request

  • Base URL
    https://services.jiopay.co.in/api
  • URL
    https://services.jiopay.co.in/api/subscription/mandate/refund
  • Auth
    none required

Headers

x-seamless'0' | '1'

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

Request body

client_idstring required

Client identifier.

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",
  "refunds": [
    {
      "subscription_refid": "SUBS11243112",
      "merchant_txn_no": "SUBS150812",
      "execute_merchant_txn_no": "SUBS15675670812"
    }
  ],
  "secureHash": "b6ade416a408311b519d34656f5894d627445d854e3011c8a3f8df8115123ae1"
}

Response

OK — batch may still contain per-item failures, see statusCode/results.

statusCodeinteger

900 at the batch level indicates a mixed/failed batch — always inspect results[] for per-item outcomes.

statusDescstring

Example response

{
  "statusCode": 900,
  "statusDesc": "All refunds failed",
  "summary": {
    "total": 1,
    "success": 1
  },
  "results": [
    {
      "statusCode": 500,
      "statusDesc": "Failed",
      "subscription_refid": "SUB84336",
      "merchant_txn_no": "SUB99373456",
      "merchantId": "JP2000000000030",
      "respDescription": "Transaction Declined",
      "merchantTxnNo": "SUB99373456",
      "responseCode": "039"
    }
  ]
}

Changes

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