post https://in.staging.decentro.tech/v2/banking/account//link
This API helps you link a current account on your platform
Link an existing business account.
Note: “Please note that Your ‘user_id’ in the request parameters should have admin privileges at the time of setting it up else the linking will not go through. You can mention the same to your account owner/customer at the time of getting the user_id created during the bank correspondent’s visit.”
Below are the values expected under the responseKey parameter and the scenarios under which Decentro will propagate the same to the platform.
| responseKey Value | Scenario |
|---|---|
| success_account_linked | The said account is successfully linked |
| error_account_linked | The said account is already linked |
| error_invalid_account_details | The credentials passed for the account are invalid as per the underlying provider |
| error_customer_registered_with_different_mobile | The mobile number used is registered against another account in the system |
| error_customer_registered_with_different_customer_id | The customer ID used is registered against another account in the system |
| error_approval_pending | The said account's linkage approval is pending |
| error_invalid_user_access | The user doesn't have the right to approve the linkage |
| error_unauthorized_feature | The said feature is not enabled for the company |
| error_unsupported_value | Unsupported or Invalid value passed for a parameter |
| error_invalid_data_type | Unsupported or Invalid data type passed for a parameter |
| error_null_or_empty_value | A null or empty value passed for a parameter |
| error_invalid_mobile | An invalid mobile number is passed |
| error_invalid_email | An invalid email ID is passed |
| error_null_or_empty_provider_params | Provider-specific parameters are not correctly passed |
| error_invalid_pan | An invalid PAN number is passed |
| error_invalid_account_number_length | The length of the account number doesn't meet the provider's criteria |
| error_internal_server_error | Error due to something at Decentros' end |
| error_provider_error | Error from the provider if nothing specific is mentioned |
| error_missing_configuration | Error due to pending configuration |