Batch Refunds

Learn how to create and cancel refunds in bulk to your customers using Batch Refunds.


Use Batch refunds to make refunds in bulk using an XLSX or CSV file. Once you upload a file, it is picked up for processing after 70 minutes. You can cancel a batch upload in the 70 minutes before it is picked up for processing.

Feature Request

This is an on-demand feature and is not available by default. To enable Batch refunds for your account,

.

A batch file can be in any of these states:

  • created: This is the initial state of the file when it is uploaded. Once you upload a file, it stays in the created state for 70 minutes. You can cancel the upload during this time.
  • processing: This state indicates that the batch file is getting processed.
  • processed: This is the final state of the file. It indicates that all the rows in the batch file were processed, either successfully or unsuccessfully. to check the status of each refund.
  • cancelled: You can only cancel batch uploads in the created state. You cannot cancel batch uploads in the processing or processed states.

Razorpay does not charge any processing fee for Normal refunds. However, the transaction fee and GST levied by Razorpay at the time of payment capture will not be reversed to your account.

Razorpay charges a small transaction fee to process Instant refunds. The fees is deducted directly from your account balance and reflects under the Refunds tab on the Razorpay Dashboard. In cases where the Instant refund fails and the refund takes 5-7 working days, the levied fee is credited back to your balance. The fee break-up is shown in the end-of-the-month invoice generated by Razorpay. View and download the details of fees charged in the Instant Refunds Reports from the Razorpay Dashboard.

For more details about pricing,

.

Watch this video to see how to create refunds in bulk using batch refund.

To create a batch refund:

  1. .
  2. Go to TransactionsBatch Refunds and click Upload New Batch.
  3. .
  4. Add the required data to the sample file. Know more about .
  5. Upload the file to the Razorpay Dashboard, check the preview to ensure details are correct, and click Submit Batch.
Create a Batch Refund

, add your data to this file and upload it for processing. We support CSV, XLS and XLSX file formats for the batch file. We do not support custom headers.

Shown below is a sample data from a batch file:

Batch File Sample Data

The below table lists the various headers in the sample batch file and briefly describes each.

Payment Id

mandatory

string The unique identifier for the payment that is to be refunded. For example, pay_F1JdjAyjRexm9T.

amount

mandatory

integer The amount, in currency sub-units, to be refunded. For example, pass 1000 to process a refund of ₹10.

speed

optional

string The speed at which the refund should be processed. Possible values:

  • optimum - Instant Refunds. If it is not possible to process the refund instantly, we will process the refund in 5-7 working days. Know more about .
  • normal - The refund is processed in 5-7 working days.

If no value is passed, the refund is processed using the

set on the Razorpay Dashboard.

You can cancel a batch upload from the Razorpay Dashboard.

Handy Tips

You can only cancel batch uploads in the created states. You cannot cancel batch uploads in the processing and processed states.

Watch this video to see how to cancel a batch refund.

To cancel a batch upload:

  1. .
  2. Go to TransactionsBatch Refunds.
  3. Click Cancel for the Batch Id that you want to cancel.

Though a batch file may have acquired processed state, all the refunds may not have been successful due to errors. For example, if an incorrect payment id is added to the file, the file might be processed, but the refund would have failed. You can download the Batch Refund report to check the status of each data row.

Watch this video to download the Batch Refund report.

To download the Batch Refund report:

  1. .
  2. Go to TransactionsBatch Refunds.
  3. Click Download for the required Batch Id to download the Batch Refund Report.
    • If a payment was successfully refunded, the corresponding data row is populated with a Refund Id.
    • If a payment was not successfully refunded, the corresponding data row is populated with an Error Code and Error Description.

Given below is a sample data from a processed batch file:

Processed Batch File Sample Data

The below table describes each of the headers of the processed batch file:

Payment Id

string The unique identifier for the payment that is to be refunded. For example, pay_F1JdjAyjRexm9T.

Amount (In Paise)

integer The amount, in currency sub-units, to be refunded. For example, pass 1000 to process a refund of ₹10.

Refund Id

string The unique identifier of the refund. For example, rfnd_EqWThTE7dd7utf.

Refunded Amount

integer The amount, in currency sub-units, refunded to the customer. For example, 1000 means ₹10 was refunded to the customer.

status

string The status of the refund. Possible values:

  • processed - The refund was successfully processed by us.
  • failure - The refund was not processed. You need to create the refund again.

Speed Requested

string The requested refund speed. Possible values:

  • optimum - Instant Refund. If it is not possible to process the refund instantly, we will process the refund in 5-7 working days. Know more about .
  • normal - The refund is processed in 5-7 working days.

If no value is passed, the refund is processed using the

set on the Razorpay Dashboard.

Error Code

string The error code for the failure. For example, BAD_REQUEST_ERROR.

Error Description

string The reason for the error. For example, The refund amount provided is greater than the unrefunded amount.