---
page_source: https://docs.juspay.io/upi-inapp/flutter/headless-process-payloads/complaint-status
page_title: Complaint Status
---


## Complaint Status




###   Process Parameters



## Request Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Value:
    - **Action**:
      - Description: String Value : upiComplaintStatus
      - Value: upiComplaintStatus
      - Tags: String, Mandatory
    - **OriginalUpiRequestId**:
      - Description: Unique Complaint Request id of the complaint on which status check is required. (gatewayComplaintId received in raise complaint API)
      - Value: Eg - APL0f018ee5bc8b428fb979cb4a53ea9bde
      - Tags: String, Mandatory
    - **OriginalTransactionUpiRequestId**:
      - Description: Unique Transaction Request id on which status check is required. 35 character alphanumeric. Should always start with the merchant prefix provided.
      - Value: Eg - APL0f018ee5bc8b428fb979cb4a53ea9bde
      - Tags: String, Mandatory
    - **Type**:
      - Description: Possible values: COMPLAINT / DISPUTE
      - Tags: String, Optional
    - **MerchantKeyId**:
      - Description: Key ID to identify the public-private key pair used for signature generation.
      - Tags: String, Mandatory
    - **SignaturePayload**:
      - Description: Signature payload is a stringified JSON of the details mentioned in the below table.
      - Value:
        - **Merchant_id**:
          - Description: Unique identifier associated with an account created by juspay. Ex: stock
          - Value: stock
          - Tags: String, Mandatory
        - **Customer_id**:
          - Description: Any unique reference associated with your customer.
          - Tags: String, Mandatory
        - **Timestamp**:
          - Description: Time when request is created in milliseconds.
          - Tags: String, Mandatory
      - Tags: String, Mandatory
    - **Signature**:
      - Description: Signature generated for the signaturePayload.
      - Tags: String, Mandatory
    - **UdfParameters**:
      - Description: Stringified json for udf parameters
      - Tags: String, Optional
  - Tags: JSON, Mandatory


## Response Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String
- **Payload**:
  - Description: Response Parameters
  - Value:
    - **Action**:
      - Description: Operation performed in the SDK
      - Value: upiComplaintStatus
      - Tags: String, Mandatory
    - **Status**:
      - Description: Status of the API
      - Value: Possible values: SUCCESS / FAILURE
      - Tags: String, Mandatory
    - **ResponseCode**:
      - Description: PSP response code for the API
      - Tags: String, Mandatory
    - **ResponseMessage**:
      - Description: PSP response message for the API
      - Tags: String, Mandatory
    - **ComplaintStatusPayload**:
      - Value:
        - **MerchantChannelId**:
          - Description: Unique id for the merchant channel as passed in request
          - Tags: String, Mandatory
        - **GatewayResponseStatus**:
          - Description: Response status returned by gateway
          - Value: OPEN | PENDING | CLOSED | FAILURE
          - Tags: String, Mandatory
        - **MerchantId**:
          - Description: Unique id for the merchant as passed in request
          - Tags: String, Mandatory
        - **GatewayComplaintId**:
          - Description: UPI request id passed in the request.
          - Value: APL123be148c7ba3b14f6db5cde57c65ccf
          - Tags: String, Mandatory
        - **ReqAdjAmount**:
          - Description: Amount of transaction sent in request
          - Value: 100.00
          - Tags: String, Mandatory
        - **GatewayResponseMessage**:
          - Description: Response message returned by gateway for the transaction.
          - Value: Your Complaint is Raised successfully
          - Tags: String, Mandatory
        - **PayerVpa**:
          - Tags: String, Mandatory
        - **MerchantRequestId**:
          - Tags: String, Mandatory
        - **GatewayResponseCode**:
          - Description: Response code returned by NPCI for the transaction
          - Value: Any valid NPCI error code
          - Tags: String, Mandatory
        - **GatewayReferenceId**:
          - Description: Complaint reference id
          - Value: eg. 465738
          - Tags: String, Mandatory
        - **ReqAdjCode**:
          - Description: Reason code for complaint sent in request
          - Value: 1082
          - Tags: String, Mandatory
        - **Crn**:
          - Description: Complaint reference number returned by NPCI
          - Value: eg. 302570532
          - Tags: String, Mandatory
        - **CustomerMobileNumber**:
          - Description: masked phone number of the customer
          - Value: <customer mobile number>
          - Tags: String, Optional
        - **PayeeVpa**:
          - Description: Payee Vpa
          - Tags: String, Mandatory
        - **ReqAdjFlag**:
          - Description: Reason flag for complaint sent in request
          - Value: eg. PBRB
          - Tags: String, Mandatory
        - **TransactionAmount**:
          - Value: eg. 1.00
          - Tags: String, Mandatory
        - **MerchantCustomerId**:
          - Description: Merchant generated unique profile id for customer as passed in the request
          - Tags: String, Optional
        - **AdjCode**:
          - Description: Reason code for complaint
          - Value: U010
          - Tags: String, Mandatory
        - **AdjFlag**:
          - Description: Reason flag for complaint
          - Value: PBRB
          - Tags: String, Mandatory
        - **AdjAmount**:
          - Description: Amount in two decimals. Decimals are mandatory.
          - Value: 0.50
          - Tags: String, Mandatory
      - Tags: JSON, Mandatory
    - **OtherInfo**:
      - Description: As passed in request
      - Tags: String, Optional
  - Tags: JSON
- **Error**:
  - Description: Possible values :- true/false
  - Tags: Boolean
- **ErrorMessage**:
  - Description: Error Message
  - Tags: String
- **ErrorCode**:
  - Description: Error Code
  - Tags: String
- **Event**:
  - Description: Value: process_result
  - Tags: String





#### Code Snippets: -

#### Java Code Snippet:

```java
{
  "service": "in.juspay.hyperapi",
  "requestId": "095fa47e-b528-457d-8310-faece4c37814",
  "payload": {
    "action": "upiComplaintStatus",
    "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f",
    "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f",
    "signature": "<signature>",
    "signaturePayload": "<signaturePayload>",
    "merchantKeyId": "1234"
  }
}

"signaturePayload": {
  "merchant_id": "stock",
  "customer_id": "XXXXXXXX",
  "timestamp": "1641533238616"
}
```

#### Kotlin Code Snippet:

```kotlin
{
  "service": "in.juspay.hyperapi",
  "requestId": "095fa47e-b528-457d-8310-faece4c37814",
  "payload": {
    "action": "upiComplaintStatus",
    "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f",
    "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f",
    "signature": "<signature>",
    "signaturePayload": "<signaturePayload>",
    "merchantKeyId": "1234"
  }
}

"signaturePayload": {
  "merchant_id": "stock",
  "customer_id": "XXXXXXXX",
  "timestamp": "1641533238616"
}
```



###   Adjustment Code Table


> **Note**
> [Click here for Adjustment Codes](../miscellaneous/adjustment-code-table)





## Sample Code Snippets:
### Request snippets:

#### Request Code Snippet:

```request
{
  "service": "in.juspay.hyperapi",
  "requestId": "095fa47e-b528-457d-8310-faece4c37814",
  "payload": {
    "action": "upiComplaintStatus",
    "originalUpiRequestId": "APL699393106f8sbsbnbnns67c59725e6891f",
    "originalTransactionUpiRequestId": "APL699393106f865d1a9467c59725e6891f",
    "signature": "<signature>",
    "signaturePayload": "<signaturePayload>",
    "merchantKeyId": "1234"
  }
}

"signaturePayload": {
  "merchant_id": "stock",
  "customer_id": "XXXXXXXX",
  "timestamp": "1641533238616"
}
```

### Response snippets:

#### Response:
```plaintext
{
  "service": "in.juspay.hyperapi",
  "requestId": "f3d954b4-e9e2-4703-8758-c8b9a488d677",
  "payload": {
    "action": "upiComplaintStatus"
    "status": "SUCCESS",
    "responseMessage": "SUCCESS",
    "responseCode": "SUCCESS",
    "complaintStatusPayload": {
      "merchantChannelId": "stockAPP",
      "gatewayResponseStatus": "FAILURE",
      "merchantId": "stock",
      "gatewayComplaintId": "ICIJP22d737c1b544f7aa55f049ad84497b",
      "reqAdjAmount": "6600.00",
      "gatewayResponseMessage": "Transaction failed",
      "payerVpa": "something@handle",
      "merchantRequestId": "45f54883f5548ddac7bd4b16bd06e1d",
      "gatewayResponseCode": "U48",
      "gatewayReferenceId": "208409676817",
      "reqAdjCode": "U010",
      "crn": "UPI22032564889",
      "customerMobileNumber": "918086332344",
      "payeeVpa": "something@handle",
      "reqAdjFlag": "PBRB",
      "transactionAmount": "1.00",
      "merchantCustomerId": "090d5030-7d17-11ec-939b-b1ce4bc73875",
      "adjCode": "U010",
      "adjFlag": "PBRB",
      "adjAmount": "0.50"
    }
  }
  "event": "process_result",
  "errorMessage": "",
  "errorCode": "",
  "error": false
}
```