Decentro provides a method to transfer funds to multiple accounts in one go by using Bulk Payout API. Decentro has built this API on top of our existing Initiate Payout API. By making use of this Bulk Payout API, customers can now transfer funds to multiple bank accounts all at once, with just a single API request. This streamlines the process and makes it more efficient for users.
To use this API, customers must pass a .csv file to the API with the following details inside the input file
Bulk Payout Input File Template
Here is a CSV Template to pass as the input file to the API. Customers can download this template
|A unique reference ID created by the customer for every transaction
|Message/Narration of the transaction being performed
|The virtual account provided by Decentro
|The Beneficiary account
|The Beneficiary UPI ID to be passed. If this field is provided, "ifsc_code" is not to be added
|UPI, IMPS, NEFT and RTGS
|The amount that needs to be transferred
|The account number which needs to be validated
|The IFSC code of the account which needs to be validated. Not required when "to_upi" is to be passed
|The URN generated for adding a beneficiary using manage beneficiary. If this field is passed, then "payee_name" and "ifsc_code" are not to be added
All of the above parameters are mandatory. The minimum number of entries is 10(Excluding the column headers) and the maximum number of entries is 100.
Please refer to Initiate Payout API request parameters on the validations being performed on each parameter
After submitting the input file to the API, the API will first examine the file's columns to ensure they are valid. Once the columns are confirmed to be correct, the API will then begin the bulk process for the inputs in the file.
After the input file has been successfully processed and the bulk processing is completed, Decentro will send the output file to the customer's registered email address. This output file will contain the results of the transaction status and details of the accounts listed in the input file.
The following details will appear in the output file
|The Unique reference ID passed by the customer for each transaction
|Decentro Transaction ID
|Unique Reference ID generated by Decentro for each Transaction
|The Beneficiary Account Number
|The Beneficiary IFSC Code
|This is the status of the validation request
Success: The request has been successfully accepted
Failure: There was a problem with the request. Please check the Error Reason column.
|The amount of the transaction
|This is the status of the transaction for the beneficiary account number
Success: The transaction was successfully processed.
Failure: The transaction failed
Pending: The transaction is in a pending state. Please check the status using Get Transaction Status API
|The transaction message
|Bank Reference Number
|The bank reference number of the transaction
|Account Holder’s Name
|The name of the beneficiary will be present here, the name will appear of the account is valid
|The balance of the virtual account after the transfer of funds
Link to Bulk Payout API
Updated about 1 month ago