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

Campo	Tipo	Descrição	Caracteres
`account_request_key`	uuidv4	Chave ú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

Campo	Tipo	Descrição	Caracteres
`account_owner` *	object	Objeto titular da conta	Objeto account_owner
`signed_contract` *	object	Objeto contento as informações do aceita eletrônico dos termos de abertura da conta.	Objeto signed_contract
`additional_documents` *	list	Lista com as `document_key` (uuidv4) dos documentos adicionais do titular da conta.	36

Objeto account_owner

Campo	Tipo	Descrição	Caracteres
`address` *	object	Objeto endereço do titular da conta	Objeto address
`cnae_code` *	string	Classificação Nacional de Atividades Econômicas	9
`company_document_number` *	string	CNPJ	14
`company_statute` *	string	DOCUMENT_KEY do PDF do estatuto da empresa (enviado previamente).	36
`company_type`	enum	Tipo da empresa	Enumeradores company_type
`company_representatives` *	list	Lista dos representantes legais da empresa	Objeto company_representatives
`email` *	string	Email institucional da empresa.	254
`foundation_date` *	string	Data de abertura da empresa (formato "AAAA-MM-DD").	10
`name` *	string	Razão social.	100
`person_type` *	enum	Identificador de que o objeto enviado é uma pessoa jurídica. Deve conter SEMPRE o valor "legal" para Objeto PJ.	Enumeradores person_type
`phone` *	object	Telefone do titular da conta.	Objeto phone
`trading_name` *	string	Nome fantasia.	200

Objeto company_representatives

Campo	Tipo	Descrição	Caracteres
`name` *	string	Nome do representante da empresa	100
`address` *	object	Objeto endereço do representante da empresa	Objeto address
`email` *	string	Email do representante da empresa	254
`birth_date` *	string	Data de nascimento representante da empresa (formato "AAAA-MM-DD")	10
`individual_document_number` *	string	CPF do representante da empresa (apenas números).	11
`document_identification`	string	DOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)	36
`document_identification_number`	string	Número do documento de identificação com foto da pessoa (RG ou CNH)	16
`document_identification_type`	enum	Tipo do documento de identificação com foto da pessoa (RG ou CNH)	Enumeradores document_identification_type
`is_pep` *	boolean	Declaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).	-
`marital_status`	enum	Estado civil do representante da empresa	Enumeradores marital status
`mother_name` *	string	Nome da mãe do representante da empresa	100
`nationality`	string	Nacionalidade do representante da empresa	50
`person_type` *	enum	Identificador de que o objeto enviado é uma pessoa física	Enumeradores person_type
`phone` *	object	Objeto com dados do telefone do representante da empresa	Objeto phone

Objeto address

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

Campo	Descrição	Exemplo	Caracteres
`street` *	string	Rua do endereço	500
`state` *	enum	Estado do endereço (com dois caracteres maiúsculos)	2
`city` *	string	Cidade do endereço	255
`neighborhood` *	string	Bairro do endereço	500
`number` *	string	Número da rua	10
`postal_code` *	string	CEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) (apenas números)	8
`complement`	string	Complemento do endereço (texto livre)	500

Objeto signed_contract

Campo	Tipo	Descrição	Caracteres
`document_key` *	uuidv4	Chave ú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` *	list	Dados de assinatura do documento enviado. Cada item da lista, corresponde a um assinante do documento.	Objeto signatures

Objeto signatures

Campo	Tipo	Descrição	Caracteres
`authenticity` *	object	Conjunto de dados que evidenciam a assinatura eletrônica realizada pelo assinante.	Objeto authenticity
`signer` *	object	Objeto contendo os dados de um dos assinantes do documento.	Objeto signer
`authentication_type` *	enumerator	Tipo de assinatura. Sempre será "opt-in"	"opt-in"

Objeto authenticity

Campo	Tipo	Descrição	Caracteres
`timestamp` *	string	Data e hora do momento da assinatura do documento.	27
`facial_recognition_key`	uuidv4	Chave ú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
`lang`	string	Coordenada de longitude da geolocalização do assinante capturada no momento da assinatura.	-
`lat`	string	Coordenada de latitude da geolocalização do assinante capturada no momento da assinatura.	-
`ip_address`	string	Endereço IP do dispositivo do assinante.	-
`session_id`	string	ID da seção do assinante no momento da assinatura.	-

Objeto signer

Campo	Tipo	Descrição	Caracteres
`name` *	string	Nome do assinante.	-
`email` *	string	Email do assinante.	-
`phone` *	object	Objeto com dados do telefone do assinante	Objeto phone
`document_number` *	string	CPF do assinante.	11

Objeto phone

Campo	Descrição	Exemplo	Máx. Caracteres
`country_code` *	string	Código DDI do telefone (https://ddi.guiamais.com.br/)	3
`area_code` *	string	Código DDD do telefone (https://ddd.guiamais.com.br/)	2
`number` *	string	Número de telefone (apenas números)	10

Enumeradores person_type

Enum	Description
`natural`	Pessoa física
`legal`	Pessoa jurídica

Enumeradores document_identification_type

Enum	Description
`rg`	RG - Registro Geral
`cnh`	CNH - Carteira Nacional de Habilitação

Enumeradores company_type

Enum	Description
`ltda`	Limitada
`sa`	Sociedade Anônima
`micro_enterprise`	Micro Empresa
`freelancer`	Freelancer
`sa_opened`	Sociedade Anônima de Capital Aberto
`sa_closed`	Sociedade Anônima de Capital Fechado
`se_ltda`	Sociedade Empresária Limitada
`se_cn`	Sociedade Empresária em Nome Coletivo
`se_cs`	Sociedade Empresária em Comandita Simples
`se_ca`	Sociedade Empresária em Comandita por Ações
`scp`	Sociedade em Conta de Participação
`ei`	Empresário Individual
`ese`	Estabelecimento, no Brasil, de Sociedade Estrangeira
`eeab`	Estabelecimento, no Brasil, de Empresa Binacional Argentino-Brasileira
`ssp`	Sociedade Simples Pura
`ss_ltda`	Sociedade Simples Limitada
`ss_cn`	Sociedade Simples em Nome Coletivo
`ss_cs`	Sociedade Simples em Comandita Simples
`eireli_ne`	Empresa Individual de Responsabilidade Limitada (de Natureza Empresária)
`eireli_ns`	Empresa Individual de Responsabilidade Limitada (de Natureza Simples)
`eireli`	Empresa de Responsabilidade Individual
`mei`	Micro Empreendedor Individual
`me`	Micro Empresa
`cop`	Cooperativa
`private_association`	Sociedade Privada

Enumeradores marital_status

Enum	Description
`single`	Solteiro(a)
`married`	Casado(a)
`widower`	Viúvo(a)
`divorced`	Divorciado(a)
`separated`	Separado(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

Campo	Tipo	Descrição	Caractéres
`account_key` *	string	Chave 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`
400	QIT000001	Bad Request	Schema Error	Erro de Schema
404	QIT000404	Not Found	Resource could not be found	Recurso não encontrado

Confirmar Abertura de Conta de Pessoa Jurídica

Request​

Path Params​

Abertura da Conta de Livre Movimentação​

Request Body Params​

Objeto account_owner​

Objeto company_representatives​

Objeto address​

Objeto signed_contract​

Objeto signatures​

Objeto authenticity​

Objeto signer​

Objeto phone​

Enumeradores person_type​

Enumeradores document_identification_type​

Enumeradores company_type​

Enumeradores marital_status​

Response​

Response Body Params​