Create Bulk Payout Links

Create and process bulk Payout Links and know about the bulk Payout Links' status.


Create Payout Links in bulk using the Bulk Payout Links feature. You can create Payout Links for:

  • Recipients whose contact details you do not know.
  • Recipients whose contact details you know.

You need your recipients' contact details to send the link. Once they receive the Payout Link, they can enter their account details. RazorpayX then creates a

and the respective .

You can create Payout Links in bulk in the following way.

To create Bulk Payout Links from the RazorpayX Dashboard:

  1. Download the .
  2. Add data to the template as per the .
  3. Upload the template on the .
Create Bulk Payout Links Process from uploaded → created → processed

Download the sample template in .csv format. Check the fields you must populate to create corresponding Payout Links.

The table below lists the requested fields listed in the

and describes each field.

Name of Contact

mandatory

string The contact's name. This field is case-sensitive. Has a minimum of 3 characters. and a maximum of 50 characters is allowed. The name cannot end with a special character, except .. Supported characters: a-z, A-Z, 0-9, space, , - , _ , / , ( , ) and , .. For example, Gaurav Kumar.

Payout Link Amount

mandatory

number The amount, in paise, to be transferred to the contact. For example, 1000. The minimum value is 100.

Contact Phone Number

mandatory

string. The contact's phone number. For example, 9000090000.

Contact Email ID

mandatory

string The contact's email address. For example, gaurav.kumar@example.com.

Send Link to Phone Number

mandatory

string Determines who sends the Payout Link to the contact via SMS. Possible values:

  • Yes: Razorpay sends the Payout Link to the contact via SMS.
  • No: You send the Payout Link to the contact via SMS.

The possible values are case-sensitive.

Send Link to Mail ID

mandatory

string. Determines who sends the Payout Link to the contact via email. Possible values:

  • Yes: Razorpay sends the Payout Link to the contact via email.
  • No: You send the Payout Link to the contact via email.

The possible values are case-sensitive.

Contact Type

mandatory

string The classification of contact that is being created. For example, employee. The following classifications are available by default:

  • vendor
  • customer
  • employee
  • self

    Handy Tips
    Additional classifications can be created from the Dashboard if required.

Payout Purpose

mandatory

string The purpose of the payout that is being created. The following classifications are available in the system by default:

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

    Handy Tips
    • Additional purposes for payouts can be created from the Dashboard if required.
    • This field is case-sensitive.

Payout Description

mandatory

string The description for the Payout Link you have created. This appears on the Payout Link hosted page.

Reference ID

optional

string A user-generated reference given to the payout. For example, Acme Transaction ID 12345. You can use this field to store your own transaction id, if any.

Internal notes: Title

optional

string You can enter custom notes for your reference. Enter the note title in this column. Notes are not visible to the contact. For example, Refund 08 Feb 2021.

Internal notes: Description

optional

string You can enter custom notes for your reference. Enter the note description in this column. Description is not visible to the contact. For example, Evening Batch.

Expiry Date

optional

string After you

, you can set the expiry date for the payout link. For example, 22/07/2021.

Expiry Time

optional

string After you

, you can enter the expiry time for the payout link. Input should be in the 24-hour format. For example, 14:52.

To upload and process a bulk file using the RazorpayX Dashboard:

  1. Log in to your .
  2. Navigate to Payout LinksBulk Payout Links+ BULK PAYOUT LINK.
    Navigating to uploading bulk Payout Links file on the X Dashboard.
  3. Download or upload the file.
    • You can download the from the Dashboard.
    • Or if your template is ready, use Click to Upload and upload the file.
  4. Click NEXT.
  5. Select the account from which you want to process the amount. This can either be your:
    • RazorpayX Lite
    • RazorpayX powered Current Account
  6. Enter the OTP sent to your registered mobile number/email address.
  7. Click CREATE PAYOUT LINK.

Handy Tips

You can also

.

After you upload the Payout Links Bulk Upload file, it moves through the following statuses:

Watch Out!

The processed state means the bulk file was fully processed. To check the status of the individual Payout Links, download the

.

Bulk Payout Links Statuses
  • created:
    This is the initial status of the bulk upload and indicates that the bulk upload was created in the RazorpayX database and is ready to be processed. No processing is done at this point.
  • processed:
    This is the final status of a bulk upload where the uploaded details are processed.

A Payout Link created using the bulk upload feature can have the following statuses during its life cycle:

  • issued
  • processing
  • processed
  • cancelled
  • expired
Payout Links States and Life Cycle

Know more about

and .


Was this page helpful?