Sign-up Fluxo Direto - Cadastro e abertura de conta digital para usuários PF

1. Objetivo

Cadastrar um novo usuário pessoa física e realizar a abertura de conta digital na plataforma de maneira simples, realizando todas as validações e integrações necessárias em uma única etapa.

2. Quem pode usar

Todos os clientes de plataforma que utilização nossa API.

3. Descrição geral

Para realizar o cadastro do usuário pessoa física são necessários alguns dados obrigatórios:

• CPF
• Selfie (base64)
• Email
• Telefone

O número de CPF é uma chave única de identificação na plataforma. Portanto, não poderá existir outro cadastro com o mesmo número de CPF na plataforma.

A seguir, serão listadas as etapas e validações de segurança que são executadas ao realizar o cadastro do usuário.

Background Check

Nessa etapa o CPF passará por uma validação de segurança e só será permitido dar sequência ao cadastro se o documento for aprovado nos seguintes itens:

Algumas dessas regras podem ser parametrizadas por plataforma. Para mais informações, contatar o atendimento ao cliente.

Verificação de identidade + SCORE

A partir da aprovação das validações de Background Check, os dados de Selfie e do CPF são enviados para um bureau de validação que irá analisar e nos retornar um score (número entre -100 e +100) que indica o nível de confiança das informações enviadas.

Esses parâmetros podem ser configurados por plataforma, seguindo o seguinte padrão inicial:

Para que a selfie seja enviada de forma correta e no formato adequado é necessário fazer a integração com o SDK do parceiro para realizar a captura da imagem.

Documentação do SDK: https://developers.unico.io/docs/check/SDK/operacaoSDKs

Os valores que determinam as regras do score podem ser parametrizados por plataforma. Para mais informações, contatar o atendimento ao cliente.

Verificação de identidade – DOCUMENTOS

Caso a validação do score fique com status PENDENTE, será obrigatório realizar a validação de identidade por meio do envio adicional do documento de identificação do usuário: RG ou CNH.

É necessário enviar as seguintes imagens em formato base 64:

• Frente do documento
• Verso do documento
• Selfie

As informações enviadas serão enviadas para um bureau de validação que irá analisar os dados e nos retornará com o status de APROVADO ou REPROVADO.

Para que as imagens sejam enviadas de forma correta e no formato adequado é necessário fazer a integração com o SDK do parceiro para a captura das imagens.

Documentação do SDK: https://docs.caf.io/sdks#faceliveness

Verificação do código de validação (challenge)

Nessa etapa é realizada a confirmação e validação do código de segurança enviado para o e-mail e/ou SMS no número de telefone informado no cadastro inicial.

As configurações de forma de envio do código de verificação, template do SMS e/ou e-mail que serão enviados ao usuário final, podem ser parametrizados por plataforma. Para mais informações, contatar o atendimento ao cliente.

Senha de login

Importante: Essa não é a senha transacional da conta digital.

O cadastro da senha de login na conta digital deve respeitar as seguintes regras:

Alguns desses parâmetros podem ser configurados por plataforma. Para mais informações, contatar o atendimento ao cliente.

Dados opcionais

Além das informações obrigatórias, também é possível preencher os campos a seguir para que o usuário seja criado com essas informações adicionais, gerando um cadastro mais robusto e detalhado:

• Nome Social
• Apelido
• Gênero
• Nome da mãe
• Nome do pai
• Exposição política (pep)
  • Data de início da exposição política
• Estado civil
• Nível de educação
• Ocupação (CBO)
• Renda média
• Patrimônio líquido
• Endereço principal
• Outros endereços
• Outros e-mails
• Outros telefones
• Outros documentos – RG, CNH, RNE, outros
  • Data de expedição
  • Data de expiração
  • Imagem do documento
  • Órgão expedidor e UF

Essas informações ficarão registradas no cadastro do usuário.

4. Etapa de registro do usuário

Primeiro endpoint que deve ser chamado para realizar o cadastro de um usuário. /v2/signup/customer/registration/direct-flow

Os seguintes dados são obrigatórios:

• Número do CPF
• Selfie
• E-mail
• Telefone

Ao enviar a requisição será verificado a existência desses dados no banco de dados da plataforma e, não havendo conflito, serão realizadas as validações de background check para o CPF informado.

Havendo conflito será retornado um erro indicando o problema.

Verificação de registro

• Registro existe e já aprovado: usuário deve concluir as demais etapas para finalizar a criação do cadastro.
• Registro existe e foi reprovado: usuário deve aguardar o prazo de 15 dias (esse valor é parametrizável) para tentar realizar um novo cadastro.
• Registro não existente: dados serão enviados para as próximas validações.

Verificação de background check

• Aprovado nas regras: dados enviados para as próximas validações
• Reprovado nas regras: retorna erro indicando o ocorrido

Verificação de identidade - SCORE

Os dados da selfie e do CPF serão enviados para a validação de identidade junto ao bureau parceiro.

• Aprovado no score estabelecido: registro do usuário é criado com o status de APROVADO e pode avançar para as demais etapas do cadastro.
• Pendente no score estabelecido: será necessário enviar as images de documentos adicionais para que os dados passem por outra validação de identidade.
• Reprovado do score estabelecido: retorna erro indicando o ocorrido e será criado um registro com o status de REPROVADO.

4.1 Pendente no score estabelecido

Se o score da validação de identidade estiver como PENDENTE, então deverá ser utilizado o endpoint /v2/signup/customer/registration/direct-flow/additional-documents para dar continuidade ao registro.

Os seguintes dados são obrigatórios:

• UUID retornado pelo endpoint de registration /v2/signup/customer/registration/direct-flow
• Selfie
• Foto da frente do documento (CNH ou RG)
• Foto do verso do documento (CNH ou RG)
• Tipo do documento (CNH ou RG)

Verificação de identidade – DOCUMENTOS ADICIONAIS

Essa verificação irá fazer uma análise das informações enviadas e o registro do usuário será atualizado para as seguintes opções:

• APROVADO: Informações enviadas foram confirmadas com sucesso e o usuário pode avançar para as demais etapas: validação do código de verificação e Finalização do cadastro.
• REPROVADO: Informações enviadas não correspondem com as regras de validação do bureau parceiro. O registro será com o status de REPROVADO e o usuário só poderá realizar uma nova tentativa após expiração do tempo pré estabelecido (15 dias por padrão).

Exemplo do fluxo de criação do registro

5. Etapa de validação do dispositivo

É necessário validar a posse do e-mail ou telefone indicados no cadastro por meio do envio de um código de verificação que deve ser confirmado pelo usuário.

O código de verificação é um código numérico de 6 dígitos enviado ao usuário através número de telefone e/ou endereço de e-mail informados na etapa de registro.

Para gerar o código de verificação e enviar ao usuário é necessário fazer uma requisição para o endpoint /v2/signup/customer/validation/send-challenge enviando o registrationUUID obtido ao finalizar o cadastro inicial do usuário.

Após o envio do código de verificação, deve-se utilizar o seguinte endpoint para confirmação do código: /v2/signup/customer/validation/validate-challenge.

O código enviado tem duração de 15 minutos por padrão (valor parametrizável).
Após expirar esse período ou o usuário informar um código de verificação inválido por 5 vezes (valor parametrizável), o código gerado é inválidado e será necessário fazer o envio de um novo código pelo mesmo endpoint de envio /v2/signup/customer/validation/send-challenge.

6. Etapa de criação do usuário e abertura da conta digital

Após realizar o registro do usuário (Direct-Flow) Cadastra um registro e envia selfie para ser validada e a confirmação do código de verificação, para finalizar a criação do usuário é necessário utilizar o seguinte endpoint: /v2/signup/customer/registration/{{registration_uuid}}/user/direct-flow

Nessa etapa são obrigatórios:

• Envio da senha para criação do login na conta digital
• Aceite dos termos de uso e políticas de privacidade

Para a criação senha serão validados os critérios de quantidade de caracteres alfanuméricos, sequênciais, etc. Se não estiver adequada irá retornar um erro informando o ocorrido.

A senha estando adequada aos critérios de validações e o usuário aceitar os termos de uso e políticas de privacidade, todas as informações coletas no registro são enviadas para os serviços que realizam a criação do usuário e a abertura da conta digital.

É nessa etapa que se pode enviar os dados opcionais para enriquecer o cadastro do usuário.

Após as integrações serem concluídas, o usuário e a conta digital são criados e ele pode realizar o login para ter acesso à sua carteira e conta digitais.

O login na plataforma deve ser realizado utilizando o CPF informado e a senha criada utilizando o endpoint /v1/login.