Check Complaint Status API

The Check Complaint Status API is to check the status of a non-BBPS complaint by passing the ID of the complaint in the request.  


Test Environment .
Production EnvironmentContact your Account Manager to get access to the production environment



Send the scope of the Get Token API as check_complain_status to obtain the access_token for this request. For more information, refer to Get Token API - BBPS.

Sample request
curl --location -g --request GET 'https://<hostName>/payu-nbc/v1/nbc/checkComplaintStatus/?&complaintId={{Complaint ID}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' 
Response parameters
Field NameDescription
codeThe global response code and can be any of the following:

- 0: If web service call failed
- 1: if web service call succeeded
statusThe status of the API command and can be any of the following:

payloadIt will contain a list of biller categories. For more information, refer to the payload table.
If the transaction had failed, it will contain:

- additional data related to transactions
- List of errors which caused failure transactions


refIdThe reference ID against which the complaint was registered.
billerReplyIt will contain the latest updated response provided by the biller.
complaintIdIt is the queried complaint ID.
billerIdBiller ID against which the complaint was registered by the customer.
complaintStatusIt is updated Status which is provided by PayU. It’s value can be CAPTURED/RESOLVED/ASSIGNED
additionalParamsFor failed transactions, it will contain additional info. If there is no any additional info available, it will be null.
Sample response

Success scenario

  "code": 200,  
  "status": "SUCCESS",  
  "payload": {  
    "refId": null,  
    "billerReply": "Not Received any response from biller yet!",  
    "complaintId": "239uu42942",  
    "billerID": "PMCBPAYU014831",  
    "complaintStatus": "CAPTURED"  

Failure scenario

  "code": 600,
  "status": "FAILURE",
  "payload": {
    "errors": [
        "reason": "<error Message>",
        "errorCode": "<Error Code>"
    "refId": "<RefId>",
    "type": "non_bbps_complain_status",
    "message": "complaint_request_failed",
    "additionalParams": {
      "Key1": "value1",
      "Key2": "value2",
      "Key3": "value3"

Request parameters

Click Try It! to start a request and see the response here!