Refunds
If you want to return the funds to your customer, for example if they returned an item, you need to refund the payment. You can initiate the refund from our dashboard or through the API. While we accept the refund instantly, you will get the outcome of the refund request asynchronously, in a REFUND webhook.
You can refund the full captured amount, a partial amount, or multiple partial amounts. The sum of the partial refunds cannot exceed the captured amount. However, note that some payment methods do not support partial refunds.
After your refund request, it can take up to 7-10 business days before the funds are returned to the customer’s account, depending on the payment method.
There are two types refunds that Cashfree supports.
- Merchant Initiated Refunds: These are the refunds that merchant initiates from your dashboard or API.
- Auto Refunds: These are funds which are reversed back to customer in case payment TTL is breached. Read more about payment TTL here.
Refund Lifecycle
Refund a Payment (API)
Cashfree Refund APIs
| API Endpoint | Method | Description | Documentation Link |
|---|---|---|---|
/api/v2023-08-01/create-refund | POST | Creates a new refund request for a payment | Create Refund API |
/api/v2023-08-01/get-refund | GET | Retrieves the current status and details of a refund | Get Refund |
You can also refund a payment from the dashboard. Payment Gateway Dashboard> Transactions> Payments.
Refund Multiple Payments (Dashboard)
Use the Batch Refunds feature to initiate refunds for a large number of payments at a time. Add all the required refund details in a single file as per the required format and upload the file. To initiate a batch refund,
Refund webhook
Configure refund webhooks to receive real-time notifications for both successful and canceled refunds. This enables you to build systems to update refund statuses and send customer communications. This is the payload for the refund status webhook. You can view the refund webhooks here.
Auto Refunds
Auto-refunds are refunds triggered automatically for unsuccessful payments, disputes, duplicate payments; or instances where payments are received directly to your VPA, regardless of whether an order has been generated.
Auto-refunds usually happen when customers
- Make a payment after the order has reached a terminal state
- Make a direct payment to our UPI Id
Auto-refund differ from standard refunds because they handle refunds that occur automatically (like failed payment attempts) rather than manual refunds tied to specific orders. Since these automatic refunds may happen before an order is created, they don’t contain the usual order-related data fields that are mandatory in standard refund webhooks. You can view the auto-refund webhooks here.
Refund Communication
We will keep customers informed about their refund status, while staying up-to-date on every stage of the process. Refunds, as reversals, involve multiple stages—initiation, processing, cancellation, and potential delays—that are essential to monitor. With Refund communication your customers receive timely notifications, helping build trust and satisfaction. Customers can also use Cashfree Customer Hub to track these refunds better.
Refund Wallet
Refund Wallets offer a streamlined and efficient solution for managing your refund process. Read through below table to understand better:
| Scenario | Without Refund Wallet | With Refund Wallet | Advantages |
|---|---|---|---|
| You want to initiate a refund of ₹500 | Current balance = 0 Refund goes on hold | Current balance = 0 Refund wallet balance = ₹5000 Refund successfully processed | ✅ Refunds without Delays |
| Get your settlements in full | Current Balance = ₹5000 Refund adjustments = ₹4300 Settled amount = ₹700 | Current Balance = ₹5000 Settled amount = ₹5000 | ✅ Effortless Reconciliation |
Was this page helpful?