Pular para o conteúdo principal

Confirmar Abertura de Conta de Pessoa Jurídica

A abertura de conta ocorre em duas etapas obrigatórias. Primeiro, uma requisição POST envia dados preliminares para reservar a conta. Em seguida, um webhook do tipo account_request.status_change com o status pending_additional_data é disparado. Na segunda etapa, uma requisição PATCH finaliza a abertura, oficializando a conta com as informações complementares.

Request

ENDPOINT
/account_request/ACCOUNT_REQUEST_KEY/checking
MÉTODO
PATCH

Path Params

CampoTipoDescriçãoCaracteres
account_request_keyuuidv4Chave única de identificação solicitação de reserva da conta.36

Abertura da Conta de Livre Movimentação

Request Body
{
"account_owner": {
"phone": {
"country_code": "55",
"area_code": "11",
"number": "999999999"
},
"email": "email@teste.com.br",
"person_type": "legal",
"name": "Empresa de Teste",
"address": {
"street": "Rua Abrahão Calux",
"state": "SP",
"city": "São Paulo",
"neighborhood": "Vila Teste",
"number": "116",
"postal_code": "04286100",
"complement": "Complemento"
},
"trading_name": "Nome fantasia",
"company_document_number": "99999999000130",
"cnae_code": "4721102",
"foundation_date": "1980-07-11",
"company_statute": "99999999-01c9-4cf5-a0fa-1d2a96f4b34d",
"company_representatives": [
{
"name": "Nome do Socio",
"individual_document_number": "99999999999",
"document_identification_number": "999999999",
"birth_date": "1989-09-01",
"mother_name": "Maria da Silva",
"email": "teste@gmail.com",
"is_pep": false,
"person_type": "natural",
"nationality": "brasileiro(a)",
"marital_status": "single",
"document_identification": "88888-0ddf-4932-874f-9231794963da",
"phone": {
"country_code": "055",
"area_code": "19",
"number": "999999999"
},
"address": {
"street": "Rua dos Limões",
"neighborhood": "Vila Moinho Velho",
"city": "São Paulo",
"state": "SP",
"postal_code": "04286100",
"number": "116",
"complement": "complemento"
}
}
],
"company_type": "ltda"
},
"signed_contract": {
"document_key": "57cda530-d469-4427-a9d4-2523a510dee1",
"signatures": [
{
"authenticity": {
"timestamp": "2024-05-10T14:15:03.114895Z",
"ip_address": "192168161",
"lang": "-35.8916627",
"lat": "-7.2226067",
"session_id": "54b8e3cf-15de-41e5-9305-0ecf059d6e2a",
"facial_recognition_key": "c367a540-2e7e-4373-a167-61bc43c30dc1"
},
"signer": {
"name": "Nome do assinante",
"email": "teste@gmail.com.br",
"phone": {
"country_code": "55",
"area_code": "11",
"number": "999999999"
},
"document_number": "99999999"
},
"authentication_type": "opt-in"
}
]
},
"additional_documents": [
"61f2a65e-0ddf-4932-874f-9231794963da"
]
}

Request Body Params

CampoTipoDescriçãoCaracteres
account_owner *objectObjeto titular da contaObjeto account_owner
signed_contract *objectObjeto contento as informações do aceita eletrônico dos termos de abertura da conta.Objeto signed_contract
additional_documents *listLista com as document_key (uuidv4) dos documentos adicionais do titular da conta.36

Objeto account_owner

CampoTipoDescriçãoCaracteres
address *objectObjeto endereço do titular da contaObjeto address
cnae_code *stringClassificação Nacional de Atividades Econômicas9
company_document_number *stringCNPJ14
company_statute *stringDOCUMENT_KEY do PDF do estatuto da empresa (enviado previamente).36
company_typeenumTipo da empresaEnumeradores company_type
company_representatives *listLista dos representantes legais da empresaObjeto company_representatives
email *stringEmail institucional da empresa.254
foundation_date *stringData de abertura da empresa (formato "AAAA-MM-DD").10
name *stringRazão social.100
person_type *enumIdentificador de que o objeto enviado é uma pessoa jurídica. Deve conter SEMPRE o valor "legal" para Objeto PJ.Enumeradores person_type
phone *objectTelefone do titular da conta.Objeto phone
trading_name *stringNome fantasia.200

Objeto company_representatives

CampoTipoDescriçãoCaracteres
name *stringNome do representante da empresa100
address *objectObjeto endereço do representante da empresaObjeto address
email *stringEmail do representante da empresa254
birth_date *stringData de nascimento representante da empresa (formato "AAAA-MM-DD")10
individual_document_number *stringCPF do representante da empresa (apenas números).11
document_identificationstringDOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)36
document_identification_numberstringNúmero do documento de identificação com foto da pessoa (RG ou CNH)16
document_identification_typeenumTipo do documento de identificação com foto da pessoa (RG ou CNH)Enumeradores document_identification_type
is_pep *booleanDeclaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).-
marital_statusenumEstado civil do representante da empresaEnumeradores marital status
mother_name *stringNome da mãe do representante da empresa100
nationalitystringNacionalidade do representante da empresa50
person_type *enumIdentificador de que o objeto enviado é uma pessoa físicaEnumeradores person_type
phone *objectObjeto com dados do telefone do representante da empresaObjeto phone

Objeto address

Este objeto, presente tanto no objeto PF quanto no objeto PJ, é um simples objeto para representar um endereço.

CampoDescriçãoExemploCaracteres
street *stringRua do endereço500
state *enumEstado do endereço (com dois caracteres maiúsculos)2
city *stringCidade do endereço255
neighborhood *stringBairro do endereço500
number *stringNúmero da rua10
postal_code *stringCEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) (apenas números)8
complementstringComplemento do endereço (texto livre)500

Objeto signed_contract

CampoTipoDescriçãoCaracteres
document_key *uuidv4Chave única de identificação do documento do Termo de Abertura de Conta ou Contrato de Conta Escrow. (A DOCUMENT_KEY é retornada na resposta do endpoint de Upload de documentos)36
signatures *listDados de assinatura do documento enviado. Cada item da lista, corresponde a um assinante do documento.Objeto signatures

Objeto signatures

CampoTipoDescriçãoCaracteres
authenticity *objectConjunto de dados que evidenciam a assinatura eletrônica realizada pelo assinante.Objeto authenticity
signer *objectObjeto contendo os dados de um dos assinantes do documento.Objeto signer
authentication_type *enumeratorTipo de assinatura. Sempre será "opt-in""opt-in"

Objeto authenticity

CampoTipoDescriçãoCaracteres
timestamp *stringData e hora do momento da assinatura do documento.27
facial_recognition_keyuuidv4Chave única de identificação da foto da selfie do titular da conta. (A DOCUMENT_KEY é retornada na resposta do endpoint de Upload de documentos)36
langstringCoordenada de longitude da geolocalização do assinante capturada no momento da assinatura.-
latstringCoordenada de latitude da geolocalização do assinante capturada no momento da assinatura.-
ip_addressstringEndereço IP do dispositivo do assinante.-
session_idstringID da seção do assinante no momento da assinatura.-

Objeto signer

CampoTipoDescriçãoCaracteres
name *stringNome do assinante.-
email *stringEmail do assinante.-
phone *objectObjeto com dados do telefone do assinanteObjeto phone
document_number *stringCPF do assinante.11

Objeto phone

CampoDescriçãoExemploMáx. Caracteres
country_code *stringCódigo DDI do telefone (https://ddi.guiamais.com.br/)3
area_code *stringCódigo DDD do telefone (https://ddd.guiamais.com.br/)2
number *stringNúmero de telefone (apenas números)10

Enumeradores person_type

EnumDescription
naturalPessoa física
legalPessoa jurídica

Enumeradores document_identification_type

EnumDescription
rgRG - Registro Geral
cnhCNH - Carteira Nacional de Habilitação

Enumeradores company_type

EnumDescription
ltdaLimitada
saSociedade Anônima
micro_enterpriseMicro Empresa
freelancerFreelancer
sa_openedSociedade Anônima de Capital Aberto
sa_closedSociedade Anônima de Capital Fechado
se_ltdaSociedade Empresária Limitada
se_cnSociedade Empresária em Nome Coletivo
se_csSociedade Empresária em Comandita Simples
se_caSociedade Empresária em Comandita por Ações
scpSociedade em Conta de Participação
eiEmpresário Individual
eseEstabelecimento, no Brasil, de Sociedade Estrangeira
eeabEstabelecimento, no Brasil, de Empresa Binacional Argentino-Brasileira
sspSociedade Simples Pura
ss_ltdaSociedade Simples Limitada
ss_cnSociedade Simples em Nome Coletivo
ss_csSociedade Simples em Comandita Simples
eireli_neEmpresa Individual de Responsabilidade Limitada (de Natureza Empresária)
eireli_nsEmpresa Individual de Responsabilidade Limitada (de Natureza Simples)
eireliEmpresa de Responsabilidade Individual
meiMicro Empreendedor Individual
meMicro Empresa
copCooperativa
private_associationSociedade Privada

Enumeradores marital_status

EnumDescription
singleSolteiro(a)
marriedCasado(a)
widowerViúvo(a)
divorcedDivorciado(a)
separatedSeparado(a)

Response

STATUS
201
Response Body
 { "account_key": "78ea0fa6-8ea6-46ff-b66b-d2bc36fc8869" }
Atenção

O campo account_request_key deve ser armazenado e será utilizado para a confirmação da abertura da conta.

Response Body Params

CampoTipoDescriçãoCaractéres
account_key *stringChave de única de identificação da conta-
STATUS
4xx
Response Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "descrição em portugues",
"code": "codigo",
"extra_fields": {}
}
Código HTTP
status
Código QI
code
Título
title
Descrição (eng)
description
Descrição(ptbr)
translation
400QIT000001Bad RequestSchema ErrorErro de Schema
404QIT000404Not FoundResource could not be foundRecurso não encontrado