API Reference

CALLBACK

SNOSTATUSCODEDESCRIPTION
1200Successful Verification.
2201Transaction failed and refunded successfully.
3202Transaction failure but amount not debited.
4422Transaction failure and amount not refunded.

SUCCESS CALLBACK

{
  "event": "BULK_VERIFY_PAN_DETAILED",
  "param": {
    "status": true,
    "statuscode": 200,
    "message": "KYC Details for PAN retrieved successfully",
    "reference_id": 21014191,
    "data": {
      "idNumber": "BHDPJ1121L",
      "idStatus": "VALID",
      "panStatus": "VALID",
      "lastName": "JAIN",
      "firstName": "SHUBHAM",
      "fullName": "SHUBHAM JAIN",
      "idHolderTitle": "Shri",
      "idLastUpdated": "13/10/2022",
      "aadhaarSeedingStatus": "Y",
      "refid": "202309271802"
    }
  }
}

FAILURE CALLBACK WITH NON-REFUNDABLE

{
  "event": "BULK_VERIFY_PAN_DETAILED",
  "param": {
    "status": false,
    "statuscode": 422,
    "message": "#failure Message#",
    "reference_id": "16902751822215",
    "data": {
      "pannumber": "1232asd",
      "refid": "202307251331"
    }
  }
}

FAILURE CALLBACK WITH REFUND

{
  "event": "BULK_VERIFY_PAN_DETAILED",
  "param": {
    "status": false,
    "statuscode": 201,
    "message": "#failure Message#",
    "reference_id": "16902751822215",
    "data": {
      "pannumber": "1232asd",
      "refid": "202307251331"
    }
  }
}

FAILURE CALLBACK WITHOUT DEBIT

{
  "event": "BULK_VERIFY_PAN_DETAILED",
  "param": {
    "status": false,
    "statuscode": 202,
    "message": "#failure Message#",
    "data": {
      "pannumber": "1232asd",
      "refid": "202307251331"
    }
  }
}

Expected Callback Response

{
  "statuscode":200,
  "message":"Transaction Success"
}
{
  "statuscode":"#response code other than 200#",
  "message":"Failure"
}