---
page_source: https://juspay.io/in/docs/upi-merchant-stack/docs/transactions/udir-refund-callback
page_title: UDIR Refund Callback
---


# UDIR Refund Callback



This callback is given when the merchant initiates a UDIR refund and when the same gets success/failure.

> **Note**
> Merchant can get multiple callbacks for the same event type till the refund status reaches a terminal state. Terminal states for a refund are SUCCESS and FAILURE.




| Parameter | Description | Type |
|---|---|---|
| gatewayRefundReferenceId | RRN for the Refund | Mandatory |
| gatewayResponseCode	 | Response code returned by gateway for the refund | Mandatory |
| gatewayResponseMessage	 | Response message for code returned by gateway for the refund | Mandatory |
| gatewayResponseStatus | Response Status Returned by Gateway for the refund | Mandatory |
| gatewayTransactionId	 | UPI request id returned by gateway for the original transaction | Mandatory |
| merchantChannelId	 | Unique id for the merchant channel as passed in request headers | Mandatory |
| merchantId | Unique id for the merchant as passed in request headers | Mandatory |
| originalMerchantRequestId | Merchant request of the original transaction | Mandatory |
| refundRequestId | Merchant generated unique id for the refund. | Mandatory |
| refundAmount	 | The amount to be refunded as passed in the request body. | Mandatory |
| riskScore | RiskScore shared by NPCI or Bank | Optional |
| subMerchantId | Unique id for subMerchant. Only if present as a subMerchant. | Optional |
| subMerchantChannelId | Unique id for the channel via which request is made. Only if present as a subMerchant. | Optional |
| type	 | Event type of the callback - MERCHANT_DEBITED_VIA_REFUND  | Mandatory |
| merchantRefundVpa | Refund VPA used for refund | Optional |
| remarks | remarks | Mandatory |
| adjCode | Reason Code for complaint sent by NPCI. | Optional |
| adjFlag | Reason flag for complaint sent by NPCI. | Optional |
| reqAdjCode | Complaint raised for Reason Code under AdjFlag | Mandatory |
| reqAdjFlag | Flag raised for complaint | Mandatory |
| crn | Complaint reference number returned by NPCI. | Optional |
| gatewayRefundTransactionId | upiRequestId returned by gateway for the refund | Mandatory |
| refundType | UDIR | Mandatory |
| refundTimestamp | Timestamp of the refund | Mandatory |


## Sample Code Snippets:
### Top Header:

#### Callback Code Snippet:

```callback
{"success":false,"message":"No Data found for the given path"}
```