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.

Solicitar Reserva de Conta

Request

ENDPOINT

/account_request/escrow

MÉTODO

POST

Request Body

{
    "account_owner": {
        "company_document_number": "99999999999",
        "email": "email@teste.com",
        "foundation_date": "2017-09-16",
        "name": "Nome da Empresa"
    },
    "legal_representatives": [
        {
            "birthdate": "1963-07-23",
            "name": "Don Corleone",
            "document_number": "03912394323",
            "documents": {
                "national_registry_of_foreigners": {
                    "ocr_front_key": "0aa8a4ca-5873-49bd-851c-1f2c71a1cc28",
                    "ocr_back_key": "29f6e346-7fae-4dcb-9ea1-2a3e4ef593ea"
                }
            },
            "face": "68da08f1-6cf4-4dce-a297-7b2f09311784"
        },
        {
            "birthdate": "1996-03-10",
            "name": "John Doe",
            "document_number": "39113492093",
            "documents": {
                "cnh": {
                    "ocr_key": "beee557e-9240-4c5b-88f1-42812b195168"
                }
            }
        }
    ]
}

Mock de CPF/CNPJ

Para simular situações de aprovação, reprovação e analise manual pode ser utilizado o primeiro digito do CPF/CNPJ do owner da conta:

0 à 7 -> Análise Manual

8 -> Reprovação Automática

9 -> Aprovação Automática

Request Body Params

Campo	Tipo	Descrição	Caractéres
account_owner *	object	Objeto contendo as informações do Titular da Conta	Objeto account_owner
legal_representatives	object array	Lista de representantes da conta e seus dados	Objeto legal_representative

Objeto account_owner

Campo	Tipo	Descrição	Caractéres
"company_document_number" *	string	CNPJ do Titular da Conta	14
email *	string	Email da empresa titular do contrato	200
foundation_date *	string	Data de abertura da empresa (formato YYYY-MM-DD)	10
name *	string	Razão Social	50

Objeto legal_representative

Campo	Tipo	Descrição	Caractéres
document_number *	string	CPF do Titular da Conta	11
birthdate *	string	Data de nascimento. (formato YYYY-MM-DD)	10
name *	string	Nome do Titular da Conta	50
documents *	object	Documento(s) do titular da conta	Objeto documents
face	uuidv4	Chave do reconhecimento facial feito junto ao antifraude (face_recognition_key)	36

Objeto documents

Campo	Tipo	Descrição	Caractéres
rg	object	Chaves OCR (OCR keys) do upload da frente e verso do RG do titular	Objeto rg
cnh	object	Chave OCR do upload da CNH do titular	Objeto cnh
national_registry_of_foreigners	object	Chaves OCR (OCR keys) do upload da frente e verso do RNE do titular	Objeto national_registry_of_foreigners

Informação

As chaves OCR (ocr_key ou ocr_front_key e ocr_back_key) do upload das imagens dos documentos são fornecidos como resposta do upload das imagens no antifraude. A face_recognition_key é retornada na resposta do reconhecimento facial.

Objeto rg

Campo	Tipo	Descrição	Caractéres
ocr_front_key *	uuidv4	Chave OCR do upload da imagem da frente do RG	36
ocr_back_key *	uuidv4	Chave OCR do upload da imagem do verso do RG	36

Objeto cnh

Campo	Tipo	Descrição	Caractéres
ocr_key *	uuidv4	Chave OCR do upload da imagem da CNH	36

Objeto national_registry_of_foreigners

Campo	Tipo	Descrição	Caractéres
ocr_front_key *	uuidv4	Chave OCR do upload da imagem da frente do RNE	36
ocr_back_key *	uuidv4	Chave OCR do upload da imagem do verso do RNE	36

Response

STATUS

201

Response Body

{
    "account_info": {
        "account_branch": "0001",
        "account_digit": "0",
        "account_number": "1693580"
    },
    "account_request_key": "f230f1b5-07af-4737-b0e3-8a472304f5e7",
    "account_request_status": "pending_kyc_analysis"
}

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_info *	object	Objeto contendo as informações do Titular da Conta	Objeto account_info
account_request_key *	string	Chave de identificação da requisição de criação	-
account_request_status *	string	Status de KYC	-

Objeto account_info

Campo	Tipo	Descrição	Caractéres
account_branch *	string	Número da Agência	4
account_digit *	string	Dígito da Conta	11
account_number *	string	Número da Conta	50

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