Definir Conta Bancária Principal

---

Introdução

Este recurso define (ou remove) uma conta bancária como conta principal do investidor dentro de uma análise cadastral. Apenas uma conta pode estar marcada como principal por vez — ao marcar uma como principal, a conta anteriormente principal é automaticamente desmarcada.

Disponível em

Perfil	Host
Investidor	investor-api

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/bank_account/{external_bank_account_key}/default

MÉTODO

PUT

STATUS

202

Request body

Request Body

{
    "value": true
}

Body params

Campo	Tipo	Descrição	Obrigatório
value	boolean	true para definir esta conta como principal	Sim

Response

202 Accepted. A representação atualizada da conta é retornada no corpo.

Erros

Status	Código	Quando acontece
400	IVR000185	A análise já foi encerrada (aprovada, recusada, concluída ou cancelada)
404	IVR000181	Conta não encontrada para o external_bank_account_key
400	IVR000193	Uma conta inativa não pode ser a principal

Erros de autenticação, permissão e host: veja Erros da API.