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 |