Bulk Validate Bank Account
This module can be used to validate large number of accounts to individuals or businesses using standard modes.
Overview
Decentro, as part of its payments module, provides various capabilities to handle features like payouts, collections, and recurring collections. While most of these capabilities work very well for one transaction at a time, they become challenging to handle when there are multiple transactions, such as payouts, VPA validation, account verification, etc. This can result in the platform having a sub-par experience and the beneficiary not getting the desired service.
Keeping this in mind, Decentro has designed its Hulk Platform that can take in tasks up to 1000s of records at a single time and process everything at its end without the platform having to work on writing scripts, etc.
Note: Decentro's dashboard will soon be having all of these features so that a platform can just leverage the same instead of these APIs.
Integration
Decentro provides the below capabilities in batch mode.
- Batch Payouts: this is designed to help platforms undertake payouts to multiple beneficiaries without having to integrate the same into their system. The Batch Payouts can be performed by passing the input as csv or JSON
- Batch Validate Bank Account: this is designed to help platforms undertake account verification of multiple beneficiaries before undertaking a payout.
Bulk Validate Bank Account
Decentro provides a method to verify a large number of bank accounts by using Bulk Validate Bank Account. Decentro has built this API on top of our existing Validate Bank Account API. By making use of this Bulk Validate API, customers can now verify 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 Validate Bank Account Input File Template
Here is a CSV Template to pass as the input file to the API. Customers can download this template
Input File
| Columns | Type | Description |
|---|---|---|
| reference_id | Text | A unique reference ID created by the customer for every transaction |
| purpose_message | Text | Purpose for the transaction |
| account_number | Text | The account number which needs to be validated |
| ifsc | Text | The IFSC code of the account which needs to be validated |
Note
All of the above parameters are mandatory. The minimum number of entries are 10(Excluding the column headers) and the maximum number of entries are 2000
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 validation process for the data contained in the file.
After the input file has been successfully processed and the bulk validation is completed, Decentro will send the output file to the customer's registered email address. This output file will contain the results of the bank account validation for the accounts listed in the input file.
The following details will appear in the output file
Output File
| Columns | Description |
|---|---|
| Reference ID | The Unique reference ID passed by the customer for each transaction |
| Decentro Transaction ID | Unique Reference ID generated by Decentro for each Transaction |
| Account Number | The Beneficiary Account Number |
| IFSC Code | The Beneficiary IFSC Code |
| Request Status | 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. |
| Penny Drop Status | 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 pending state. Please check the status using Get Transaction Status API |
| Bank Account Status | This is the status of the beneficiary bank account Valid: The account is valid Invalid: The account is invalid |
| Error Reason | If there are any errors that occur during the bulk validation, please refer to this column on what was the error |
| Account Holder’s Name | The name of the beneficiary will be present here, the name will appear of the account is valid |
Link to Bulk Validate Bank Account API
Updated about 2 months ago