Troubleshooting — Resolução de Problemas

Este guia ajuda a diagnosticar e resolver os problemas mais comuns encontrados no portal.

---

Problemas de Acesso e Login

Não consigo fazer login — credenciais inválidas

Causas possíveis:

1. Senha digitada incorretamente — verifique se o Caps Lock está ativado.
2. E-mail informado diferente do cadastrado.
3. Conta desativada pelo administrador.

Solução:

• Clique em Esqueci minha senha para redefinir.
• Se persistir, contate o administrador da conta ou o suporte FastGivr.

---

Sessão encerrando constantemente

Causa: Sessões são encerradas após 30 minutos de inatividade.

Solução:

• Interaja com o portal periodicamente.
• Se estiver trabalhando com abas inativas, abra o portal em uma aba ativa.
• Verifique se o relógio do seu computador está sincronizado — divergência de horário pode causar expiração de token precoce.

---

Página em branco ou tela de carregamento infinito

Soluções:

1. Pressione Ctrl+Shift+R (Windows/Linux) ou Cmd+Shift+R (Mac) para recarregar sem cache.
2. Limpe os cookies e dados do site.
3. Teste em outro navegador (Chrome, Firefox, Edge).
4. Desative extensões de navegador (ad-blockers podem interferir).

---

Erro "Sem permissão para acessar esta página"

Causa: Seu perfil de usuário não tem acesso à área solicitada.

Solução: Solicite ao Administrador da conta que ajuste suas permissões em Configurações → Contas Vinculadas.

---

Problemas com Pix

QR Code gerado mas pagamento não aparece

Possíveis causas:

1. O pagador ainda não realizou o pagamento.
2. Problema temporário na comunicação entre bancos.
3. QR Code expirado antes do pagamento.

Diagnóstico:

• Peça ao pagador que confirme o pagamento no aplicativo do banco.
• Verifique se o QR Code não está expirado (confira o prazo na tela de geração).
• Aguarde até 60 segundos — o processamento pode ter um leve atraso.

Solução:

• Se o pagador confirmar que pagou mas o status não atualizou: contate o suporte FastGivr com o ID da transação e o comprovante do pagador.

---

Transferência Pix rejeitada — "Chave não encontrada"

Causa: A chave Pix informada não existe no DICT (Diretório de Identificadores de Transações do PIX do Banco Central) ou foi excluída pelo titular.

Solução:

• Verifique a chave com o beneficiário.
• Tente um formato diferente de chave (CPF em vez de e-mail, por exemplo).

---

Transferência Pix com status "Em processamento" por mais de 10 minutos

Causa: Situação rara — pode indicar lentidão no banco parceiro ou no Banco Central.

Solução:

• Em horário comercial: aguarde até 30 minutos.
• Se persistir: contate o suporte com o ID da transferência.

---

Problemas com Boleto

Boleto gerado mas PDF não abre

Soluções:

1. Verifique se há um bloqueador de pop-ups no navegador — desative-o para o portal.
2. Tente clicar em Download novamente após alguns segundos.
3. Teste em outro navegador.

---

Boleto pago mas status ainda aparece como "Pendente"

Causa: A compensação bancária leva D+1 útil. O status é atualizado após o banco confirmar a liquidação.

Solução:

• Aguarde até o próximo dia útil.
• Se após 2 dias úteis o status não atualizar: contate o suporte com o comprovante de pagamento.

---

Cliente informa que o código de barras está inválido

Causas:

1. O boleto foi cancelado antes do pagamento.
2. O código foi copiado com erro.
3. O boleto ultrapassou o prazo de pagamento aceito pelo banco do pagador.

Solução:

• Verifique o status do boleto no portal.
• Se ainda Pendente, gere um novo PDF e envie ao cliente.
• Se Cancelado, emita um novo boleto.

---

Problemas com Cobranças

Cobrança criada mas link público não abre

Causas:

1. A cobrança foi excluída após a criação.
2. Problema temporário no servidor.

Solução:

• Verifique se a cobrança ainda aparece como Ativa na listagem.
• Tente acessar o link em modo anônimo (aba privada) para descartar problema de cache.

---

E-mail de cobrança não chegou ao cliente

Verificações:

1. O e-mail cadastrado no cliente está correto?
2. O e-mail caiu na caixa de spam do cliente?
3. O domínio do e-mail do cliente bloqueia remetentes externos?

Solução:

• Clique em Notificar novamente na cobrança.
• Envie o link manualmente por WhatsApp ou outro canal.
• Verifique os logs de envio em Notificações.

---

Problemas com Webhooks

Webhook não está sendo entregue

Diagnóstico passo a passo:

1. Acesse Webhooks → Logs de Entrega.
2. Verifique o código HTTP retornado pela sua URL.
3. Identifique a mensagem de erro específica.

Soluções por tipo de erro:

Código HTTP	Causa	Solução
404 Not Found	URL incorreta ou rota não existe	Corrija o endpoint cadastrado
500 Internal Server Error	Erro no seu servidor	Verifique os logs do seu servidor
401/403 Unauthorized	Bloqueio de autenticação	Remova autenticação da rota de webhook
Timeout	Seu servidor demorou mais de 5s	Otimize o processamento ou use filas
Connection Refused	Servidor offline ou firewall	Verifique se o servidor está rodando

---

Webhook duplicado (mesmo evento entregue duas vezes)

Causa: Normal em sistemas de alta disponibilidade — retentativas podem causar entrega duplicada.

Solução: Implemente idempotência no seu endpoint: verifique se o ID do evento já foi processado antes de executar a lógica de negócio.

// Exemplo de idempotência simples
$eventId = $request->input('data.id');
if (Event::where('external_id', $eventId)->exists()) {
    return response()->json(['message' => 'already_processed'], 200);
}
// Processa o evento...

---

Problemas de Performance no Portal

Portal lento para carregar listagens

Soluções:

1. Reduza o período do filtro (evite "Todo o período" em bases grandes).
2. Use filtros específicos para limitar o volume de dados.
3. Verifique a velocidade da sua conexão com a internet.
4. Limpe o cache do navegador.

---

Exportação de relatório demora muito

Causa: Relatórios com muitos registros levam mais tempo.

Solução:

• Exporte por períodos menores (mês a mês em vez do ano inteiro).
• A exportação ocorre em segundo plano — não feche a aba enquanto processa.

---

Contato com Suporte

Se o problema persistir após as soluções acima:

1. Acesse /suporte no portal.
2. Informe:
   • Descrição do problema
   • Prints de tela (quando aplicável)
   • IDs de transações afetadas
   • Horário em que ocorreu o problema
3. Tempo de resposta: até 2 horas em dias úteis (8h às 18h).

E-mail direto: suporte@fastgivr.com.br