Enviar Conta Bancária do Investidor

---

Introdução

Este recurso cadastra uma conta bancária para o investidor dentro de uma análise cadastral. Cada conta deve ser enviada em uma requisição independente — para cadastrar mais de uma conta, chame o endpoint múltiplas vezes.

Input / Output

Como input envie os dados de uma conta bancária.

Como output será retornada a conta criada, incluindo a chave bank_account_key gerada.

Request

ENDPOINT

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

MÉTODO

POST

STATUS

201

Request body

Exemplo: conta principal individual

Request Body

{
    "financial_institution_code": "341",
    "account_number": "12345678",
    "account_digit": "9",
    "account_branch": "0001",
    "main_account": true
}

Exemplo: conta conjunta

Request Body

{
    "financial_institution_code": "341",
    "account_number": "12345678",
    "account_digit": "9",
    "account_branch": "0001",
    "shared_account_owners": [
        {
            "name": "Maria Silva",
            "document_number": "068.045.160-95"
        }
    ]
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
financial_institution_code	string	Código da instituição financeira (compe / ISPB curto)	1 - 4	Sim
account_number	string	Número da conta bancária (apenas dígitos)	1 - 20	Sim
account_digit	string	Dígito verificador da conta	1	Sim
account_branch	string	Número da agência (4 dígitos)	4	Sim
main_account	boolean	Indica se é a conta principal do investidor	-	Não
shared_account_owners	array	Lista de objetos de Shared Account Owner	-	Não

informação

Apenas uma conta pode ser marcada como main_account: true. Se nenhuma conta for marcada como principal, a primeira cadastrada é assumida como principal.

Shared Account Owners

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do co-titular da conta	-	Sim
document_number	string	CPF do co-titular (XXX.XXX.XXX-XX)	14	Sim

Response

A conta bancária criada é retornada no corpo, incluindo external_bank_account_key e status.