Prerequisite

Learn about the prerequisites of our Upload file API.

Plural upload file API use the file uploaded in the request and process the individual payouts in a queue. You must enter the bank account details in the below format.

clientReferenceIdbeneficiaryIdpayeeNameaccountNumberbranchCodevpaemailphoneamountCurrencyamountValuemodedateTimeremarkssaveBeneficiaryvalidate
test1607-2819150E32EB7CB2Kevin1234567890123ICICI0000139[email protected][email protected]9876543210INR100IMPSFormat: yyyy-MM-dd'T'HH:mm:ss'ZRenttruefalse
test1607-2819160E32EB7CB3Bob1234567890124ICICI0000140[email protected][email protected]9876543211INR1000IMPSFormat: yyyy-MM-dd'T'HH:mm:ss'ZSalarytruefalse

The table below lists all the fields that must be included in the file to be uploaded using our Upload File API for processing a bulk payout.

ParameterTypeRequired TypeDescription
clientReferenceIdstringMUnique identifier entered while creating a Payout request.

Example: test1607-281915
beneficiaryIdstringOUnique Identifier representing the beneficiary.

Example: 0E32EB7CB2
payeeNamestringCBeneficiary name.

Example: Kevin
accountNumberstringCBeneficiary bank account number.

Example: 1234567890123
branchCodestringCBeneficiary branch IFSC.

Example: ICICI0000139
vpastringCBeneficiary VPA handle.

Example: [email protected]
emailstringOBeneficiary email address.

Example: [email protected]
phonestringOBeneficiary phone number.

Example: 9876543210
amountCurrencystringMType of currency.

Example: INR
amountValuestringMThe transaction amount is Paisa.
  • Minimum value: 100 (₹1).
  • Maximum value: 100000000 (₹10 lakh).
Example: 100
modestringMMode you wish to initiate a payout.

Accepted values:
  • UPI
  • IMPS
  • NEFT
  • RTGS
dateTimestringOUse this parameter to schedule a payout for future. The time value is in UTC.

Example: yyyy-MM-dd'T'HH:mm:ss'Z
remarksstringMPayout remarks.

Example: Rent
saveBeneficiarybooleanOAccepted values to save beneficiary.
  • true: Beneficiary details are saved against the account.
  • false: Beneficiary details are not saved against the account.
validatebooleanOAccepted values to validate the VPA handle before initiating a payout.
  • true: VPA verification is done.
  • false: VPA verification is not done.