Portal do Cliente
O portal do cliente permite que os clientes finais de cada organização gerenciem suas assinaturas, faturas e métodos de pagamento de forma autônoma.
Acesso
O portal é acessado via URL personalizada da organização. Cada organização configura seu portal com branding, domínio e funcionalidades específicas.
Funcionalidades do Portal
- Visualizar e pagar faturas
- Gerenciar assinaturas (pausar, cancelar, se permitido)
- Atualizar métodos de pagamento
- Visualizar histórico de transações
- Aceitar/rejeitar propostas comerciais
Usuário do Portal (PortalUser)
| Campo | Descrição |
|---|---|
| Único por conta de cobrança | |
| Conta de cobrança | Vínculo com a conta financeira |
| Apenas SSO | Se true, login apenas via SSO |
| Status | Estado do usuário |
Status do Usuário
| Status | Descrição |
|---|---|
active | Usuário ativo com acesso completo |
pending_verification | Aguardando verificação de e-mail (signup) |
pending_invitation | Aguardando aceitar convite |
suspended | Conta suspensa |
locked | Bloqueado por tentativas de login falhas |
Segurança
- Senhas hasheadas com bcrypt
- Tokens de verificação/reset baseados em HMAC
- Bloqueio automático após tentativas de login falhas
- Tokens de verificação expiram em 24 horas
- Tokens de convite expiram em 7 dias
Convites
O sistema de convites permite que a organização envie convites por e-mail:
- O convite é enviado com um token temporário (7 dias)
- O destinatário aceita e define sua senha
- O status muda para
active - Convites pendentes podem ser cancelados ou reenviados
Cadastro Self-Service
Organizações podem habilitar cadastro público:
- O cliente acessa a página de signup via slug único
- Informa CNPJ (validado na Receita Federal via API minhareceita.org)
- Preenche dados da empresa e administrador
- Um e-mail de verificação é enviado
- Após verificação, o acesso é liberado
Validação de CNPJ
- CNPJ deve estar com situação cadastral "Ativa"
- CNPJ não pode já estar cadastrado na organização
- CNPJs com situação "Baixada" são bloqueados
Configuração do Portal
| Configuração | Descrição |
|---|---|
| Nome da empresa | Nome exibido no portal |
| Logo | Logotipo claro e escuro |
| Cores | Tema claro e escuro (HSL) |
| Idiomas | Idiomas disponíveis (padrão: pt-BR, en-US) |
| Pagamentos | Métodos habilitados (cartão, boleto, PIX) |
| Assinaturas | Permitir pausar/cancelar |
| Convites | Habilitar convites e domínios permitidos |
| Signup | Slug e habilitar cadastro público |
| SSO | Chave pública, algoritmo e emissor |
SSO (Single Sign-On)
O portal suporta SSO via JWT:
- Algoritmos suportados: RS256, RS384, RS512, ES256, ES384, ES512, PS256, PS384, PS512
- Configurar chave pública PEM e emissor (iss claim)
- Usuários SSO-only não precisam de senha
Captura de tela
A tela /dashboard/portal reúne a configuração visual e funcional do portal do cliente: logo, paleta de cores para tema claro e escuro, idiomas suportados, domínio customizado, texto do e-mail de convite, métodos de pagamento habilitados, autenticação (link mágico, OAuth, JWT SSO) e quais áreas o cliente pode ver/editar.
Para a documentação das telas vistas pelo cliente final, consulte Portal do Cliente.