JIjiopay
Mandate

Initiate Mandate

Creates a recurring-payment mandate (UPI AutoPay or Card Standing Instruction). Two request shapes are supported depending on the flow:

  • Seamless (mandates[0].isSeamless: "1"): client_id at the top level, mandate fields wrapped in a mandates array. Response returns a redirectURI for the customer to complete authentication.
  • Non-seamless (isSeamless: "0"): all fields flat at the top level, no mandates wrapper. Response returns a generated mandate_link instead.
post/subscription/mandate

Request

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

Request body

OR

Example request

{
  "client_id": "11182576a878438aa94ef7bee1507764f08d74131e41dc75",
  "mandates": [
    {
      "customer_ref_id": "CUST_10010",
      "amount": "10.00",
      "authAmount": "1.00",
      "start_date": "2026-09-09",
      "end_date": "2028-08-08",
      "collectByDate": "2026-09-17 17:45:22",
      "subscription_refid": "subs3657443532",
      "consent": true,
      "customer_name": "John Doe",
      "customer_mobile": "9219135156",
      "customer_email": "test@jiopay.in",
      "debitDay": "0",
      "debitRule": "NA",
      "remark": "Mandate Initiated",
      "purpose": "RECURRING",
      "card": {
        "cardNo": "23509712015765",
        "cardExpiryMonth": "03",
        "cardExpiryYear": "2031",
        "cvv": "123",
        "cardHolderName": "John Doe"
      },
      "payerVA": "parasyadav0502-1@oksbi",
      "udfFields": {
        "udf_1": "TEST123",
        "udf_2": "TEST456"
      },
      "link_expiry": 1,
      "link_expiry_time": "20270131122600",
      "secureHash": "b6ade416a408311b519d34656f5894d627445d854e3011c8a3f8df8115123ae1"
    }
  ]
}

Response

OK

statusCodeinteger
statusDescstring

Example response

{
  "statusCode": 200,
  "statusDesc": "Bulk mandate processing completed",
  "summary": {
    "total": 1,
    "success": 1
  },
  "results": [
    {
      "statusCode": 201,
      "statusDesc": "Mandate intiate request processed successfully.",
      "subscription_refid": "subs3657443532",
      "response": {
        "redirectURI": "https://jiopay.co.in/pg/api/mandate/redirect",
        "merchantId": "JP2000000000016",
        "responseDescription": "Request processed successfully",
        "merchantTxnNo": "MTXT1788954159288M5637",
        "tranCtx": "R01a085fa-28d7-77a1-82f6-c2bd7bc3b9f4",
        "aggregatorId": "JP2000000000001",
        "responseCode": "R1000"
      }
    }
  ]
}

Changes

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