Pular para o conteúdo principal

Abertura de conta PF

Request

ENDPOINT
/account
MÉTODO
POST
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": "1o. Andar"
},
"birth_date": "1990-05-06",
"document_identification": "3c24579b-9810-4fa6-9b08-fe67d237160a",
"email": "api@qitech.com.br",
"individual_document_number": "34651104630",
"is_pep": false,
"mother_name": "Maria Mariane",
"name": "Qi Tech Ltda.",
"nationality": "nationality",
"person_type": "natural",
"phone": {
"country_code": "055",
"area_code": "11",
"number": "999999999"
},
"proof_of_residence": "780456bd-1eec-4e5f-82c0-d8c3921497ea"
},
"signed_contract": {
"document_key": "4d7f4e29-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.000",
"session_id": "jdifj329842"
},
"signer": {
"name": "IVANILDO DE SENA LIMA",
"email": "teste@gmail.com",
"phone": {
"country_code": "055",
"area_code": "11",
"number": "999999999"
},
"document_number": "99999999999"
},
"authentication_type": "opt-in"
}
]
}
}
Copiando e Colando o Payload de exemplo

Antes de iniciar os testes, a document_key do campo document_identification deve ser substituida pela chave retornada no upload de documentos dos titulares da conta.

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

BODY PARAMS

CampoTipoDescriçãoCaracteres
account_ownerobjectObjeto Dono da contaObjeto account_owner
signed_contract *objectObjeto contento as informações da assinatura do contrato.Objeto signed_contract

Objeto account_owner

CampoTipoDescriçãoCaracteres
addressstringEndereço do cliente.Objeto adress
birth_date *stringData de nascimento da pessoa (formato "AAAA-MM-DD")
document_identification *stringDOCUMENT_KEY do PDF do documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)
document_identification_back *stringDOCUMENT_KEY do PDF do verso documento de identificação da pessoa com foto (RG ou CNH) (enviado previamente)
document_identification_type *stringTipo do documento enviado previamente (RG ou CNH)
email *stringEmail do cliente.
individual_document_numberstringCPF da pessoa (apenas números). Limitado a 11 caracteres.
is_pep *stringDeclaração se a pessoa é PEP (http://www.portaldatransparencia.gov.br/download-de-dados/pep).
mother_name *stringNome da mãe do cliente em caso de PF.100
name *stringRazão social em caso de operações PJ ou Nome da pessoa em caso de operações PF.100
nationality *stringNacionalidade do cliente.50
person_type *stringIdentificador de que o objeto enviado é uma pessoa física ou jurídica.
phonestringObjeto com dados do telefoneObjeto phone
proof_of_residencestringDOCUMENT_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.

CampoDescriçãoExemploMáx. Caracteres
street *stringRua do endereço100
state *stringEstado do endereço (com dois caracteres maiúsculos)2
city *stringCidade do endereço100
neighborhood *stringBairro do endereço100
number *stringNúmero da rua10
postal_code *stringCEP do endereço (http://www.buscacep.correios.com.br/sistemas/buscacep/) (apenas números)8
complement *stringComplemento do endereço (texto livre)100

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

Response

STATUS
200
Response Body
{
"data": {
"account_info": {
"account_branch": "0001",
"account_digit": "3",
"account_number": "70091",
"financial_institution_code": "329",
"account_key": "7986dcc7-4331-478f-af47-adfbdf7f4a36"
},
"account_owner": {
"document_number": "08141163701",
"name": "Aurora Simone Catarina Nogueira"
}
},
"event_datetime": "2019-11-04 16:34:41",
"key": "f834af4d-ab4b-442f-96c9-f9940d8066d4",
"status": "pending_kyc_analysis",
"webhook_type": "account"
}
STATUS
400
Response Body
{
"data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}