Atualizar Status da Conta Bancária

---

Introdução

Este recurso altera o status de uma conta bancária previamente cadastrada em uma análise cadastral — por exemplo, para inativar uma conta que não deve mais ser utilizada.

A conta é identificada pela sua chave externa (external_bank_account_key), retornada na criação.

Disponível em

Perfil	Host
Distribuidor	distributor-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}/status

MÉTODO

PUT

STATUS

202

Request body

Request Body

{
    "status": "inactive"
}

Body params

Campo	Tipo	Descrição	Obrigatório
status	string	Novo status da conta. Valores típicos: active, inactive	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	IVR000075	Valor de status inválido
400	IVR000074	Não é possível desativar a conta principal

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