Confirmar Abertura de Conta de Pessoa Física

Como segunda etapa da abertura de conta pessoa física, após a reserva de conta, devem ser enviados os dados cadastrais completos do titular e evidências do aceite nos termos de abertura da conta.

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

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"
            }
        ]
    },
    "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 evidências do aceito do Titular quanto aos termos de abertura da conta.	Objeto signed_contract

Objeto account_owner

Campo	Tipo	Descrição	Caracteres
`address` *	string	Endereço do cliente.	Objeto address
`birth_date` *	string	Data de nascimento da pessoa (formato "AAAA-MM-DD")
`document_identification` *	string	DOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)
`document_identification_type` *	string	Tipo do documento enviado previamente (RG ou CNH)
`email` *	string	Email do cliente.
`individual_document_number`	string	CPF da pessoa (apenas números). Limitado a 11 caracteres.
`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.	100
`name` *	string	Razão social em caso de operações PJ ou Nome da pessoa em caso de operações PF.	100
`nationality` *	string	Nacionalidade do cliente.	50
`person_type` *	string	Identificador de que o objeto enviado é uma pessoa física ou jurídica.
`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	Descrição	Exemplo	Máx. Caracteres
`street` *	string	Rua do endereço	100
`state` *	enum	Estado do endereço (com dois caracteres maiúsculos)	2
`city` *	string	Cidade do endereço	100
`neighborhood` *	string	Bairro do endereço	100
`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)	100

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

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

Request​

Path Params​

Request Body Params​

Objeto account_owner​

Objeto address​

Objeto signed_contract​

Objeto signatures​

Objeto authenticity​

Objeto signer​

Objeto phone​

Response​

Response Body Params​