Cadastro de Conta Bancária do Investidor

Este endpoint permite o cadastro de conta bancária associada a um investidor previamente cadastrado.

---

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/bank_account

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres
INVESTOR-KEY	string	Chave única do investidor (UUID v4).	36

Request Body

Response Body

{
  "account_number": "12345678",
  "account_digit": "1",
  "account_branch": "1234",
  "financial_institution_code_number": "001",
  "financial_institution_ispb": "00000000",
  "account_type": "checking"
}

Request Body Params

Campo	Tipo	Descrição	Máximo de Caracteres
account_number *	string	Número da conta bancária. Deve conter apenas dígitos.	20
account_digit *	string	Dígito verificador da conta. Deve conter um único dígito.	1
account_branch *	string	Número da agência bancária. Deve conter apenas dígitos.	6
financial_institution_code_number	string	Código da instituição financeira (3 dígitos).	3
financial_institution_ispb *	string	Código ISPB da instituição financeira (8 dígitos).	8
account_type *	string	Tipo da conta bancária.	Enumeradores account_type

Enumeradores account_type

Enum	Description
checking	Conta corrente
savings	Conta Poupança
salary	Conta Salário
payment	Conta de Pagamento

Response

STATUS

201

Response Body

{
  "bank_account_key": "123e4567-e89b-12d3-a456-426614174000",
  "account_number": "12345678",
  "account_digit": "1",
  "account_branch": "1234",
  "financial_institution_code_number": "001",
  "financial_institution_ispb": "00000000",
  "account_type": "checking"
}

Response Body Params

Campo	Tipo	Descrição	Máximo de Caracteres
bank_account_key	string	Identificador único da conta bancária cadastrada (UUID v4).	36
account_number	string	Número da conta bancária.	20
account_digit	string	Dígito verificador da conta bancária.	1
account_branch	string	Número da agência bancária.	6
financial_institution_code_number	string	Código da instituição financeira.	3
financial_institution_ispb	string	Código ISPB da instituição financeira.	8
account_type	string	Tipo da conta bancária.	Enumeradores account_type