post
https://in.staging.decentro.tech/v2/banking/remitter
Important Note
Please use only Staging Credentials on each API Reference page to test the APIs directly from our Documentation.
API Endpoints
| Environment | Endpoint |
|---|---|
| Staging / Sandbox | https://in.staging.decentro.tech/v2/banking/remitter |
| Production | https://in.decentro.tech/v2/banking/remitter |
Manage Remitter API is an API that can be used for whitelisting your virtual accounts to accept funds only from these whitelisted accounts and then perform payouts. You can ADD remitter accounts to which whitelisting need to be made and DISABLE the configured whitelisting. Link to Documentation of Whitelisting Remitter Accounts
API Specifications
| Request Parameter | Mandatory (M) / Optional (O) / Conditional Mandatory (CM) | Description |
|---|---|---|
| action | M | ADD/DISABLE are the actions available |
| virtual_account | M | The virtual account number against the remitter will be whitelisted.The virtual account added must belong to the provider selected. |
| va_ifsc | M | Virtual Account IFSC code to be added. 1. Alphanumeric values are allowed as per the IFSC code assigned to the beneficiary bank. 2. Maximum length is 11 characters |
| configure_remitter_accounts | M | Object |
| remitter_name | CM | The Remitter Account Name must be passed. Mandatory if action is ‘ADD’ |
| remitter_account_number | CM | Remitter Account Number to be added. Mandatory if action is ‘ADD’ |
| remitter_ifsc_code | CM | Remitter IFSC code to be added. 1. Mandatory if action is ‘ADD’ 2. Alphanumeric values are allowed as per the IFSC code assigned to the beneficiary bank. 3. Maximum length is 11 characters |
| remitter_code | CM | A URN generated against the remitter account configured. Mandatory if action is ‘DISABLE’ |
Simulation Data
The simulation data must be used for remitter account details to simulate the account validation flow.
| Scenario | Remitter Name | Remitter Account Number | Remitter Account IFSC |
|---|---|---|---|
| Remitter Account is valid | Account 212 | 123456789011 | SBIN0001077 |
| Remitter Account is invalid | - | 123456789013 | HDFC0001234 |
For a successful response when the remitter account is whitelisted, please ensure that the Virtual Account name matches the remitter’s name.