Criação de uma entidade Alias

É o Fluxo responsável por criar entidades Alias, atreladas a uma conta jś existente.

Request

ENDPOINT

/account/ACCOUNT_KEY/alias

MÉTODO

POST

Request Body

{
    "request_control_key":"5b4259a4-dc4a-489f-a050-3391e13d9850",
    "account_branch": "0001",
    "account_number": "4968698",
    "account_digit": "3",
    "account_type": "checking_account",
    "account_created_at": "2022-09-24T19:46:43.001Z",
    "owner_person_type": "legal",
    "owner_document_number": "89248771384257",
    "owner_name": "Vinicius De Oliveira",
    "owner_trading_name": "Pix Ltda"
}

Path Params

Campo	Tipo	Descrição	Caracteres
account_key	uuidv4	Chave única da conta.	36

Request Body Params

Campo	Tipo	Descrição	Max. Caracteres
request_control_key *	string	Chave única de identificação da request utilizada pelo cliente no formato uuidv4	36
account_branch *	string	Agência, sem o dígito verificador	4
account_number *	string	Número de conta, sem o dígito verificador	20
account_digit *	string	Dígito verificador da conta	1
account_type*	enumerador	Tipo da conta	Enumerador account_type
account_created_at *	string	Data de criação da conta. Ex: "2022-09-24T19:46:43.001Z"	20
owner_document_number *	string	Numero de CPF ou CNPJ	11(CPF) ou 14(CNPJ)
owner_person_type *	string	Tipo de dono da conta. Pode ser legal ou natural	7
owner_name *	string	Nome do dono da conta	120
owner_trading_name	string	Nome fantasia do dono da conta (opcional, e somente para CNPJ)	100

Enumerador account_type

Enumerador	Descrição
checking_account	Conta Corrente
salary_account	Conta Salário
saving_account	Conta Poupança
payment_account	Conta de Pagamentos

Response

STATUS

201 created

Response Body

{
  "alias_key": "e04f496b-47be-4762-a6e2-8f2b05b46780",
  "created_at": "2022-09-24T19:46:43.001Z"
}

Response Body Params

Campo	Tipo	Descrição	Max. Caracteres
alias_key	uuidv4	Chave única do alias	36
created_at	datetime Zulu	Data de realização da requisição	20

STATUS

404

Response Body: Not Found

  {
    "title": "Not Found", 
  "description": "Account not found for the given key \{account_key\}", 
  "translation": "A account_key \{account_key\} não foi encontrada",
  "extra_fields": {}, 
  "code": "ACC000006"
}

STATUS

400

Response Body: Repeted Request Control Key

  {
  "title": "Repeated Request Control Key", 
  "description": "The request_control_key sent \{request_control_key\}, was already been used in other requisition", 
  "translation": "A request_control_key enviada \{request_control_key\}, já foi utilizada em outra requisição",
  "extra_fields": {}, 
  "code": "ACC000179"
}

Response Body: Invalid owner trading name

  {
  "title": "Bad Request", 
  "description": "The owner_trading_name can only be sent by a legal person type", 
  "translation": "O owner_trading_name s\u00f3 pode ser utilizado por uma pessoa jur\u00eddica",
  "extra_fields": {}, 
  "code": "ACC000180"
}