About Bulk Payouts

Understand how to create and process Bulk Payouts in RazorpayX.


Process payouts in bulk using the Bulk Upload feature on the RazorpayX Dashboard. You can perform the following:

Alternatively, you can also

.

Handy Tips

You can

for the field in the Bulk Upload file.

To create payouts in bulk, you must first upload the all payout details such as the account number, payout amount, currency, mode, and so on to the

.

To process bulk payouts, you must:

  1. Download the .
  2. Fill in the data as per the .
  3. Upload the file using available on RazorpayX.

Watch Out!

Before you upload the file using Bulk Upload, ensure that the cell data type is converted to plain text. Sometimes, sheets created using Google Sheets or other such applications are converted to scientific format, which is not accepted by the system.

Find the sample templates for .csv and .xls file types below.

Watch Out!

.xls files that contain more than 10,000 rows are not processed.

File TypeSample Template
.csv (>10,000 rows)
.xls (<10,000 rows)

The table below lists the various required fields in the template and gives a brief description of each field.

RazorpayX Account Number

mandatory

string The account from which you want to make the payout. For example, 7878780080316316. Account details can be found on the

under My Account & SettingsBankingAccount No.

Handy Tips

Ensure the account number format is not changed when uploading the file.

  • Pass your customer identifier if you want money to be deducted from your RazorpayX Lite.
  • Pass your Current Account number if you want money to be deducted from your Current Account.

Payout Amount

mandatory

number The amount, in INR, to be transferred from the business account to the contact's Fund account.

  • Enter 369.05 to create a payout for the amount ₹369.05.
  • You cannot pay any amount less than ₹1.
  • Only upto 2 decimals is allowed. If your amount reads 1.495, round it off to the nearest value to retain only two decimals.

Payout Currency

mandatory

string The currency in which the payout is being made. Here, it has to be INR.

Payout Mode

mandatory

string The mode that should be used to make the payout.

Watch Out!

The payout modes are case sensitive. When creating payouts using APIs, ensure payout modes are entered in upper case.

  • account_type = vpa use UPI.
  • account_type = bank_account:
    • NEFT
    • RTGS
    • IMPS

Payout Purpose

mandatory

string The purpose of the payout that is being created.

Handy Tips

  • This field is case-sensitive.
  • Additional purposes for payouts can be created via the , if required.

The following classifications are available in the system by default:

  • refund
  • cashback
  • payout
  • salary
  • utility bill
  • vendor bill

Payout Narration

optional

string This is a custom note that also appears on the bank statement.

Maximum length 30 characters. Allowed characters are: a-z, A-Z. 0-9 and space.

Handy Tips

  • If no value is passed for this parameter, it defaults to the Merchant Billing Label.
  • Ensure the most important text in the first 9 characters as banks may truncate the rest as per their standards.

Payout Reference Id

optional

string A user-generated reference given to the payout. For example, Acme Transaction ID 12345.

Maximum length is 40 characters.

You can use this field to store your own transaction id, if any.

Fund Account Id

conditionally mandatory

string The unique id linked to a Fund account. For example, fa_00000000000001.

Handy Tips

This field is mandatory if you want to make a payout to an existing Fund account. This way you do not need to provide other Fund account and contact details. Know more about

.

Fund Account Type

mandatory if Fund Account id not given

string The type of account to be linked to the customer id. Possible values:

  • bank_account
  • vpa

Fund Account Name

mandatory if Fund Account id not given and Fund Account Type = bank_account

string Name of the account holder as per bank records.

For example, Gaurav Kumar.

Fund Account Ifsc

mandatory if Fund Account id not given and Fund Account Type = bank_account

string Bank IFSC of the account number.

For example, HDFC0000053.

Fund Account Number

mandatory if Fund Account id not given and Fund Account Type = bank_account

string Beneficiary account number.

For example, 765432123456789.

Fund Account Vpa

mandatory if Fund Account id not given and Fund Account Type = vpa

string The virtual payment address. For example, gauravkumar@upi.

Contact Type

mandatory if Fund Account id not given

string The classification of contact that is being created. For example, employee.

Handy Tips

Additional classifications can be created via the

, if required.

The following classifications are available in the system by default:

  • vendor
  • customer
  • employee
  • self

Contact Name

mandatory if Fund Account id not given

string Name of the contact. For example, Gaurav Kumar.

Contact Email

optional

string Email address for the contact.

For example, gaurav.kumar@example.com

Contact Mobile

optional

string. Phone number for the contact. For example, 9123456789.

Contact Reference Id

optional

string A user-generated reference given to the contact. For example, Acme Contact ID 12345.

Maximum length is 40 characters.

notes[example text]

optional

string Notes for the details being imported. You can replace the example text in the header with text of your choice. You can add up to 15 notes. Text in the header is the title and text in the cell is the value for the note.

Once your template is ready with the required data, you can log into your

to process your payouts in bulk. You can schedule your payouts your Bulk Upload file and process them at a future date.

To create and upload the bulk payouts file:

  1. Log into your .
  2. Navigate to PayoutsBulk on your Dashboard.
  3. Download or upload the file.
  4. Upload the file and click NEXT.
  5. In Preview Upload, check if the data is accurate. RazorpayX will show the top 4 rows as the preview details.
  6. Click NEXT and enter the OTP before clicking CREATE PAYOUT.

Watch Out!

Your payouts created using the Bulk Upload feature cannot be queued. If your account balance is insufficient, the payouts will fail. Know more about the

.

To schedule bulk payouts:

  1. Navigate to PayoutsBulk on your .
  2. Click + BULK PAYOUTS and upload your file. Click NEXT.
  3. In the Preview Upload pop-up, select the Schedule the payout checkbox.
  4. Choose the date and the time slot when you want the system to process the payouts in the Bulk Upload file. You can schedule payouts up to 3 months in advance. Following are the 4 time slots available:
    • 9 a.m. to 10 a.m.
    • 1 p.m. to 2 p.m.
    • 5 p.m. to 6 p.m.
    • 9 p.m. to 10 p.m.
  5. Enter your OTP to authenticate the Bulk Upload process.
  6. Click CREATE PAYOUT.

The payouts in your bulk payouts file are now scheduled.

Handy Tips

  • After a bulk file is uploaded, the file is processed immediately. Individual payouts created are scheduled as per the options selected.
  • You can cancel your payouts until 1 minute before the scheduled time.

After the bulk file is uploaded, it is picked up for processing immediately. Payouts created via the Bulk Upload feature go to the pending or scheduled status. It then follows the

.