API ReferenceIntegrationsKnowledge Base

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, raise a request on our Support Portal.

Batch States🔗

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. Download the Batch Refund Report 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.

Refund Fees🔗

Normal Refunds🔗

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.

Instant Refunds🔗

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, contact our Support Team.

Create a Batch Refund🔗

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

To create a batch refund:

  1. Log in to Razorpay Dashboard.
  2. Go to TransactionsBatch Refunds and click Upload New Batch.
  3. Download a sample file.
  4. Add the required data to the sample file. Learn more about Batch File Fields.
  5. Upload the file to the Razorpay Dashboard, check the preview to ensure details are correct, and click Submit Batch.

Batch File - Fields🔗

Download the sample file, 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:

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

Payment Idmandatory
string The unique identifier for the payment that is to be refunded. For example, pay_F1JdjAyjRexm9T.
amountmandatory
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 Instant Refunds.
  • normal - The refund is processed in 5-7 working days.

    If no value is passed, the refund is processed using the default speed set on the Razorpay Dashboard.

Cancel a Batch Upload🔗

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. Log on to Razorpay Dashboard.
  2. Go to TransactionsBatch Refunds.
  3. Click Cancel for the Batch Id that you want to cancel.

Batch Refund Report🔗

When a batch file reaches the processed state, it does not necessarily mean that all payments were successfully refunded. There is a chance that a few payments were not refunded because of some error. For example, because the payment ID entered was wrong. Download the Batch Refund report to check the status of each individual data row.

Watch this video to download the Batch Refund report.

To download the Batch Refund report:

  1. Log on to Razorpay Dashboard.
  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.

Batch Report - Fields🔗

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

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 Instant Refunds.
  • normal - The refund is processed in 5-7 working days.

    If no value is passed, the refund is processed using the default speed 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.
×