If you configure the refund event URL on the PayU Dashboard, you will receive the status of refund. Refund status callback allows you to receive the final status of a refund unlike webhook where your are kept informed with status of refund. For more information on configuring webhook on Dashboard, refer to Webhooks for Refunds.
Note: To enable the Refund Status Callback, contact your PayU KAM or PayU Support.
Success Response
{
"additionalValue1": null,
"bank_arn": 308239782136,
"refund_mode": "Instant Credit through UPI",
"bank_ref_num": "308239782136",
"key": "lF76TH",
"amt": "149.00",
"remark": null,
"status": "success",
"token": "DG0036362",
"mihpayid": "17025521702",
"request_id": "11865427756",
"merchantTxnId": "ORDER_33172661_1679394745",
"additionalValue2": null,
"action": "refund"
}Failure Response
{
"additionalValue1": null,
"bank_arn": null,
"refund_mode": "Instant Credit through UPI",
"bank_ref_num": "100142082006",
"key": "IahMJL",
"amt": "72.00",
"remark": null,
"status": "failure",
"token": "PZT2506150013OR4AN33",
"mihpayid": " 23907365951 ",
"request_id": "17265314530",
"merchantTxnId": "PZT2506150013OR4AN02",
"additionalValue2": null,
"action": "refund"
}Response Parameters Description
| Parameter | Description | Source Data |
|---|---|---|
| merchantTxnId | String Merchant Sale transaction id Character Limit: 50 | |
| mihpayid | String payuid Character Limit: max 255 chars | Var1 for refund initiate API |
| bank_arn | String Reference number for refund tracking Character Limit: 45 | |
| bank_ref_num | String Bank reference number Character Limit: 255 | |
| request_id | String Unique refund id generated by payu Character Limit: 255 | |
| token | String Unique refund txn id provided by merchant Character Limit: 23 | Var2 for refund initiate API |
| action | String refund Character Limit: 32 | |
| amt | String Refund amount Character Limit: 65 | Var3 for refund initiate API |
| status | String Status of the refund Character Limit: 32 | Possible values: success/failure |
| additionalValue1 | For future scope | |
| additionalValue2 | ||
| key | String Merchant key Character Limit: 20 | |