Fluxos Principais do Sistema

Esta seção descreve os fluxos operacionais mais importantes da plataforma FastGivr, do início ao fim de cada processo.

---

Fluxo de Vida de uma Cobrança

O ciclo completo de uma cobrança segue os seguintes estados:

Criada → Pendente → Pago
                 ↘ Falhou / Expirado
                 
Pago → Estornado
     → Contestado (Chargeback)

Detalhamento dos Estados:

Estado	Gatilho	Próximo Estado Possível
Pendente	Cobrança gerada no sistema	Pago, Falhou, Expirado
Pago	Confirmação de pagamento pelo banco	Estornado, Contestado
Falhou	QR Code expirado ou cartão recusado	— (terminal)
Estornado	Reembolso solicitado e processado	— (terminal)
Contestado	Chargeback aberto pelo portador do cartão	— (aguardando resolução)

---

Fluxo de Recebimento via Pix

1. Usuário cria QR Code (Portal → /receber-pix)
2. Cliente escaneia QR Code com app do banco
3. Cliente confirma o pagamento no banco
4. Banco Central processa a transação (~3 segundos)
5. FastGivr recebe notificação do banco parceiro
6. Transação registrada como "Pago"
7. Saldo creditado em Saldo Disponível (D+0)
8. Notificação em tempo real no Portal
9. Webhook disparado para sua URL (se configurado)

Tempo total: 3 a 10 segundos após o pagamento do cliente.

---

Fluxo de Emissão e Pagamento de Boleto

1. Usuário cria boleto (Portal → /criar-boleto)
2. FastGivr registra boleto no banco parceiro (Sicredi/Sicoob)
3. Boleto gerado com código de barras e linha digitável
4. PDF disponível para download e envio ao cliente
5. Cliente realiza pagamento no banco ou app bancário
6. Banco liquida o boleto (D+1 útil)
7. FastGivr recebe confirmação via webhook do banco
8. Status atualizado para "Pago"
9. Saldo creditado em Saldo Disponível
10. Notificação enviada ao usuário do portal

Tempo total de liquidação: 1 dia útil após o pagamento.

---

Fluxo de Transferência Pix (Saque)

1. Usuário acessa /transferir-pix
2. Informa chave Pix de destino
3. Sistema consulta dados do beneficiário no DICT (Banco Central)
4. Usuário confirma beneficiário e valor
5. FastGivr verifica saldo disponível
6. Transferência enviada ao banco parceiro
7. Banco Central processa e credita na conta destino
8. Status atualizado para "Concluído"
9. Saldo debitado da conta FastGivr
10. Comprovante gerado e disponível no extrato

Tempo: Instantâneo em horário comercial; até 60 minutos em horários alternativos.

---

Fluxo de Cobrança Pública (Link de Cobrança)

1. Usuário cria cobrança no portal
2. Sistema gera URL pública: /cob/:code
3. Usuário compartilha link com cliente (WhatsApp, e-mail etc.)
4. Cliente acessa a URL sem precisar de login
5. Cliente escolhe o método de pagamento disponível
6. Para Pix: QR Code é exibido → cliente paga
7. Para Boleto: PDF gerado → cliente realiza o pagamento
8. Para Cartão: formulário de cartão exibido
9. Pagamento processado e status atualizado
10. Notificação ao usuário do portal

---

Fluxo de Estorno / Reembolso

1. Usuário localiza a transação paga (Portal → Cobranças ou Extrato)
2. Clica em "Estornar"
3. Informa se é estorno total ou parcial
4. Para Pix: estorno direto em segundos
5. Para Boleto: coleta dados bancários do pagador
6. Para Cartão: processado pela operadora em até 2 ciclos
7. Status atualizado para "Estornado"
8. Saldo debitado da conta FastGivr
9. Notificação ao usuário e ao cliente

---

Fluxo de Chargeback (Contestação de Cartão)

1. Portador do cartão contesta compra no banco emissor
2. Operadora notifica FastGivr
3. FastGivr debita valor do saldo (Reserva de Chargeback)
4. Notificação enviada ao usuário do portal
5. Usuário tem 10 dias úteis para apresentar defesa
6. Usuário envia documentos comprobatórios no portal
7. Operadora analisa (até 45 dias)
8. Resultado: Vencido (valor devolvido) ou Perdido (saldo não devolvido)

---

Fluxo de Webhook (Notificação para Sistemas Externos)

1. Evento financeiro ocorre (ex: pagamento confirmado)
2. FastGivr identifica webhooks configurados para o evento
3. POST HTTP enviado para cada URL cadastrada
4. Seu sistema recebe e processa o payload
5. Seu sistema responde com HTTP 200
6. FastGivr registra entrega como "Sucesso"

→ Se a URL retornar erro:
   4b. FastGivr agenda retentativa automática
   5b. Após 4 falhas, webhook marcado como "Com Erro"
   6b. Alerta exibido no portal para o usuário

---

Diagrama Geral de Integração

┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Cliente   │────▶│  Portal FastGivr │────▶│   Banco Parceiro│
│  (Pagador)  │     │  (API + Portal)  │     │ Sicredi/Sicoob  │
└─────────────┘     └──────────────────┘     └─────────────────┘
                            │                         │
                            │ Webhook                 │ Liquidação
                            ▼                         ▼
                    ┌───────────────┐      ┌──────────────────┐
                    │  Seu Sistema  │      │  Banco Central   │
                    │  (ERP/CRM)    │      │      (DICT/PIX)  │
                    └───────────────┘      └──────────────────┘