📘 Fluxo de Login e Primeiro Acesso

Integração Mega → Infox → Elo

Este documento descreve o fluxo de autenticação e primeiro acesso do sistema, integrando as bases Mega, Infox e Elo. O fluxograma abaixo ilustra o comportamento esperado e os pontos de integração via API.

🔗 Ver fluxograma visual interativo

📋 Fluxo Detalhado

1. Login com CPF

O usuário informa o CPF no formulário de login.

2. Consulta por CPF

A API realiza busca sequencial nas bases de dados:

3. Pessoa Localizada

Quando a pessoa é encontrada em alguma das bases, o sistema identifica a origem.

4. Fluxo por Origem

4.1. Origem: Mega

4.2. Origem: Infox ou Elo

5. Salvar Formulário

Após preenchimento/atualização dos dados, o formulário é salvo temporariamente.

6. Validação de Primeiro Acesso

6.1. Se isFirst = true

📱 Autenticação Multifator (MFA)

O sistema envia um código de validação via SMS para o telefone cadastrado do usuário.

Validação do Código

  • ✅ Código válido: Prossegue para criação de senha
  • ❌ Código inválido: Retorna para envio de novo SMS

🔐 Criação de Senha

Após validação MFA bem-sucedida:

  • Usuário cria sua senha de acesso
  • Dados salvos na base Mega
  • Flag isFirst definida como false
🔌 Validação do Cartão – Infox
PUT /{sufixo}/cartao/desbloqueio
📥 Request Body
{
  "token": "string",
  "senha": "stringstringstringstringstringstri",
  "documento": "0689057102",
  "data_nascimento": "29/06/2068"
}
✅ Response (201 CREATED)
{
  "resposta": {
    "codigo": "35",
    "mensagem": "ESTADO DO CARTÃO INVÁLIDO PARA ESTA OPERAÇÃO"
  }
}
🔌 Validação do Cartão – Elo
POST /contadigital/v1/costumer/cards
POST /contadigital/v1/card/validate

6.2. Se isFirst = false

7. Acesso Liberado

Usuário é redirecionado ao Dashboard/Sistema.

🔧 Integração de APIs

As APIs e payloads completos (Infox e Elo) devem ser implementados conforme as respostas esperadas. O fluxo visual serve como referência para o comportamento do sistema em cada etapa do login e validação.