This API allows partners to check refund status for any refund transaction. All of them are mandatory parameters.
Request parameters
Note:
The header must include bearer token.
Parameter | Description | Example |
---|---|---|
merchant_id mandatory |
| 8244519 |
payu_id |
| 403**371553**93059 |
reseller_id |
| 11ed-933c-ece48d50-a41d-023f883eb17c |
hash |
|
Sample request
Response parameters
JSON Parameter | Description | Example |
---|---|---|
mihpayuid |
| 7043873219 |
bank_ref_num |
| 305**9158352 |
request_id |
| 11751172957 |
amt |
| 10.00 |
mode |
| UPI |
action |
| refund |
token |
| 2020**05secrettokenatur |
status |
| success |
bank_arn |
| 74799877**2005071**8062 |
settlement_id |
| N2232115984**659 |
amount_settled |
| null |
UTR_no |
| SBIN717020**1388 |
value_date |
| 2021-10-10 |
refund_mode |
| Back to Source |
Sample response
Success scenario
{
"40**9371**29864745": {
"135848905": {
"settlement_id": null,
"mihpayid": 4039937**529**4745,
"amt": "2.12",
"amount_settled": null,
"token": "whatsapp_basudev_Refund",
"bank_arn": null,
"mode": "NB",
"refund_mode": "Back to Source",
"action": "refund",
"bank_ref_num": null,
"request_id": 1358**905,
"status": "queued",
"UTR_no": null,
"value_date": null
},
"135**3655": {
"settlement_id": null,
"mihpayid": 4039937**529**4745,
"amt": "3.13",
"amount_settled": null,
"token": "whatsapp_basudev_Refund",
"bank_arn": null,
"mode": "NB",
"refund_mode": "Back to Source",
"action": "refund",
"bank_ref_num": null,
"request_id": 1358**655,
"status": "queued",
"UTR_no": null,
"value_date": null
}
}
}
Failure scenarios
- Invalid partner
- Error code=400
Status : BAD_REQUEST(400)
{
"message": "Partner with UUID 121**12213r is not allowed to do this action"
}
- Invalida auth token
- Error code=401
{
"message": "Invalid Auth token"
}
- Invalid hash
- Error code=403
{
"message": "Invalid Hash"
}
- Invalid PayU ID
- Error code=400
STATUS: BAD_REQUEST(400)
{
"40399**15528864745": {
"errorCode": "400",
"description": "0 out of 1 Transactions Fetched Successfully",
"category": "RefundService",
"data": ""
}
}
- Any other issues in middleware
Response Status: INTERNAL_SERVER_ERROR(500)
{
"message": "PayU Internal Server Error"
}