---
page_source: https://juspay.io/in/docs/upi-plugin-direct-psp/android/base-integration/refund-callback
page_title: Refund Callback
---


# Refund Callback



This callback is given when the merchant initiates a 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 |
|---|---|---|
| customResponse	 | Stringified JSON parameter for future use. | Optional |
| refundGatewayReferenceId	 | RRN for the Refund | Optional |
| 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 | Optional |
| 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 |
| merchantRefundReason | Reason for the refund | Mandatory |
| merchantRefundVpa | Merchant refund vpa that is to be used for online refund | Optional |
| merchantRequestId | Merchant request of the original transaction | Mandatory |
| refundMerchantRequestId | Merchant request of the refund transaction | Optional |
| 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 |
| transactionAmount	 | The total amount for which original transaction was performed | Mandatory |
| type	 | Event type of the callback - CUSTOMER_ONLINE_REFUND / CUSTOMER_OFFLINE_REFUND | Mandatory |
| udfParameters 	 | Udf parameters as passed in the request | Optional |