curl -X GET 'https://api.rzp.<bank>.com/v1/complaints?upi_transaction_id=1232341412&refresh=true&limit=4&offset=10&status=success' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "Authorization: Bearer <token>" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: customer-id-from-customer" \
{
"entity": "collection",
"count": 1,
"items": [
{
"entity": "upi.complaint",
"reference_id": "123214121",
"upi_reference_id": "123214121",
"request_adjustment_amount": 500,
"request_adjustment_code": "U010",
"request_adjustment_flag": "PBRB",
"upi_customer_reference_number": "CRN987654321",
"adjustment_amount": 500,
"adjustment_code": "102",
"adjustment_flag": "PR2C",
"payee": {
"vpa": "acme.corp@rzp",
"name": "AcmeCorp Pvt. Ltd."
},
"status": "success",
"description": "Complaint for failed transaction under review",
"upi_transaction_id": "1232341412",
"upi_original_transaction_id": "1232341412",
"created_at": 1705411200
}
]
}
{
"error": {
"code": "BAD_REQUEST_ERROR",
"description": "upi_original_transaction_id is mandatory",
"source": "internal",
"step": "",
"reason": "",
"field": "upi_original_transaction_id",
"metadata": null
}
}
Fetch Complaints
Retrieve the status of a specific complaint or fetch all complaints for a customer.
GET
/
v1
/
complaints?upi_transaction_id=1232341412&refresh=true&limit=4&offset=10&status=success
curl -X GET 'https://api.rzp.<bank>.com/v1/complaints?upi_transaction_id=1232341412&refresh=true&limit=4&offset=10&status=success' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "Authorization: Bearer <token>" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: customer-id-from-customer" \
{
"entity": "collection",
"count": 1,
"items": [
{
"entity": "upi.complaint",
"reference_id": "123214121",
"upi_reference_id": "123214121",
"request_adjustment_amount": 500,
"request_adjustment_code": "U010",
"request_adjustment_flag": "PBRB",
"upi_customer_reference_number": "CRN987654321",
"adjustment_amount": 500,
"adjustment_code": "102",
"adjustment_flag": "PR2C",
"payee": {
"vpa": "acme.corp@rzp",
"name": "AcmeCorp Pvt. Ltd."
},
"status": "success",
"description": "Complaint for failed transaction under review",
"upi_transaction_id": "1232341412",
"upi_original_transaction_id": "1232341412",
"created_at": 1705411200
}
]
}
{
"error": {
"code": "BAD_REQUEST_ERROR",
"description": "upi_original_transaction_id is mandatory",
"source": "internal",
"step": "",
"reason": "",
"field": "upi_original_transaction_id",
"metadata": null
}
}
Available in🇮🇳 India
Use this endpoint to fetch the status of a specific complaint or retrieve a list of complaints.
curl -X GET 'https://api.rzp.<bank>.com/v1/complaints?upi_transaction_id=1232341412&refresh=true&limit=4&offset=10&status=success' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "Authorization: Bearer <token>" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: customer-id-from-customer" \
{
"entity": "collection",
"count": 1,
"items": [
{
"entity": "upi.complaint",
"reference_id": "123214121",
"upi_reference_id": "123214121",
"request_adjustment_amount": 500,
"request_adjustment_code": "U010",
"request_adjustment_flag": "PBRB",
"upi_customer_reference_number": "CRN987654321",
"adjustment_amount": 500,
"adjustment_code": "102",
"adjustment_flag": "PR2C",
"payee": {
"vpa": "acme.corp@rzp",
"name": "AcmeCorp Pvt. Ltd."
},
"status": "success",
"description": "Complaint for failed transaction under review",
"upi_transaction_id": "1232341412",
"upi_original_transaction_id": "1232341412",
"created_at": 1705411200
}
]
}
{
"error": {
"code": "BAD_REQUEST_ERROR",
"description": "upi_original_transaction_id is mandatory",
"source": "internal",
"step": "",
"reason": "",
"field": "upi_original_transaction_id",
"metadata": null
}
}
Query Parameters
string
Fetch the complaint status for the specific transaction id.
Watch Out!This value should be alphanumeric and a maximum of 35 characters are allowed. The value should start with a prefix given by NPCI to Switch.
boolean
Determines whether to fetch payment status from NPCI. Possible values:
true: If set to true, fetch payment status from NPCI.false(default): If set to false, return payment from the local database.
integer
Maximum number of records to return. Used for pagination.
integer
Offset value for pagination.
string
The status of the complaint. Possible values:
initiatedsuccessfailure
Response Parameters
string
The entity type. Here, it is
collection.integer
Indicates the number of items in the entity type.
object
The complaint details.
string
Entity type. Here it is
upi.complaint.string
Business-generated complaint reference id.
string
Identifier returned by Razorpay for the complaint.
integer
The amount of the transaction sent by NPCI (in paise), when the complaint was raised.
string
Code representing complaint reason from NPCI, when the complaint was raised..
string
Flag associated with the complaint reason from NPCI, when the complaint was raised..
string
Complaint id shared by NPCI.
integer
The amount of the transaction sent by NPCI, in paise.
string
Code representing complaint reason from NPCI.
string
Flag associated with the complaint reason from NPCI.
object
The payee details.
string
The VPA of the payee.
string
The name of the payee.
string
Indicates the complaint status. Possible values:
initiatedactivecompletedpausedfailed
string
Acknowledgement or status description.
string
UPI transaction id related to the complaint.
string
Original UPI transaction id used at the time of payment.
string
The UNIX timestamp at which the complaint was created.
Last modified on October 8, 2026
Was this page helpful?