Confirmar Abertura de Conta de Pessoa Física

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/escrow

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 de conta Escrow

Request Body

{
    "account_owner": {
        "address": {
            "street": "Av. Brigadeiro Faria Lima",
            "state": "SP",
            "city": "São Paulo",
            "neighborhood": "Jardim Paulistano",
            "number": "2391",
            "postal_code": "01452905",
            "complement": "Complemento"
        },
        "birth_date": "1990-05-06",
        "document_identification": "3884579b-9810-4fa6-9b08-fe67d237160a",
        "email": "teste@gmail.com",
        "individual_document_number": "99999999999",
        "is_pep": false,
        "mother_name": "Dona Maria Mariane",
        "name": "Nome do Titular da Conta",
        "nationality": "nationality",
        "person_type": "natural",
        "phone": {
            "country_code": "055",
            "area_code": "11",
            "number": "999999999"
        },
        "proof_of_residence": "4d7f4e-1eec-4e5f-82c0-d8c3921497ea"
    },
    "signed_contract": {
        "document_key": "48a8f4g9-4b58-4905-9a69-b1f9215263f5",
        "signatures": [
            {
                "authenticity": {
                    "timestamp": "1970-01-01T00:00:01.080100Z",
                    "facial_recognition_key":"79003de0-2590-455d-9b73-426b8ca284eb",
                    "lang": "-35.8916627",
                    "lat": "-7.2226067",
                    "ip_address": "177.51.1.186",
                    "session_id": "jdifj329842"
                },
                "signer": {
                    "name": "Nome do Titular da Conta",
                    "email": "teste@gmail.com",
                    "phone": {
                        "country_code": "055",
                        "area_code": "11",
                        "number": "999999999"
                    },
                    "document_number": "999999999"
                },
                "authentication_type": "opt-in"
            }
        ]
    },
    "destinations": [
        {
            "account_branch": "0001",
            "account_number": "1234567",
            "account_digit": "1",
            "document_number": "04252012000123",
            "name": "Conta do FIDC",
            "ispb_number": "32402502",
            "financial_institution_code_number": "329"
        }
    ],
    "additional_documents": ["b12c8807-8f3f-4083-9cb1-7cce641f3786"]
}

Request Body Params

Campo	Tipo	Descrição	Caractéres
`account_owner` *	object	Objeto contendo as informações do Titular da Conta	Objeto account_owner
`signed_contract` *	object	Objeto contendo as informações do Titular da Conta	Objeto signed_contract
`destinations` *	list	Lista de contas destino autorizadas a receber transaferências.	Objeto destinations
`additional_documents` *	list	Lista de id's de documentos extras/opcionais .	Array de UUID's

Objeto account_owner

Campo	Tipo	Descrição	Caracteres
`address` *	object	Endereço da pessoa titular da conta.	Objeto adress
`birth_date` *	string	Data de nascimento da pessoa titular da conta(formato "AAAA-MM-DD")	-
`document_identification` *	uuidv4	DOCUMENT_KEY do PDF do documento de identificação da pessoa titular da conta com foto (RG ou CNH) (enviado previamente)	36
`email` *	string	Email da pessoa titular da conta.	200
`individual_document_number`	string	CPF da pessoa titular da conta (apenas números). Limitado a 11 caracteres.	11
`is_pep` *	string	Declaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).	-
`mother_name` *	string	Nome da mãe do cliente em caso de PF.	-
`name` *	string	Nome do titular da conta.	-
`nationality` *	string	Nacionalidade do cliente.	-
`person_type` *	enumerator	Identificador de que o objeto enviado é uma pessoa física ou jurídica.	Enumeradores person_type
`phone` *	string	Objeto com dados do telefone	Objeto phone
`proof_of_residence`	string	DOCUMENT_KEY do PDF do comprovante de endereço do endereço enviado (enviado previamente).	-

Objeto address

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

Campo	Tipo	Descrição	Caracteres
`street` *	string	Rua do endereço	500
`state` *	string	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 destinations

Campo	Tipo	Descrição	Caracteres
`account_branch` *	string	Número da Agência da conta destino.	4
`account_number` *	string	Número da conta destino.	-
`account_digit` *	string	Dígito verificador do número da conta destino.	1
`document_number` *	string	CPF/CNPJ do titular da conta destino.	-
`name`	string	Nome/Razão Social do titular da conta destino.	-
`ispb_number` *	string	ISPB (base do CNPJ) da instituição financeira da conta destino.	8
`financial_institution_code_number` *	string	Código da instituição financeira da conta destino.	3

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"

Enumeradores person_type

Enum	Descrição
natural *	Pessoa Física
legal *	Pessoa Jurídica

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/)	3
`number` *	string	Número de telefone (apenas números)	10

Response

STATUS

201

Response Body

{
    
    "account_key": "e48eb139-448e-43b9-9aee-df5f4b51158c"
}

Atenção

O campo account_key será a chave única de identificação da conta. Toda interação com a conta se dará através dela.

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 Física

Request​

Path Params​

Abertura de conta Escrow​

Request Body Params​

Objeto account_owner​

Objeto address​

Objeto destinations​

Objeto signed_contract​

Objeto signatures​

Enumeradores person_type​

Objeto authenticity​

Objeto signer​

Objeto phone​

Response​