⚙️ Fluxos do Sistema & Regras de Negócio
Esta seção descreve os principais fluxos operacionais da FastGivr Money e as regras de negócio regulatórias e comerciais aplicadas às transações financeiras.
🔁 Fluxo de Vida das Cobranças (Transações)
O ciclo de vida de uma cobrança segue um fluxo de transição de estados rígido e auditável:
mermaid
stateDiagram-v2
[*] --> Pendente : Cobrança Gerada
Pendente --> Pago : Pagamento Confirmado
Pendente --> Falhou : Expiração ou Recusa do Cartão
Pago --> Estornado : Reembolso Solicitado (Total/Parcial)
Pago --> Contestado : Chargeback Recebido do Banco Emissor
Falhou --> [*]
Estornado --> [*]
Contestado --> [*]- Pendente: Aguardando ação do pagador (Pix/Boleto) ou validação de anti-fraude (Cartão).
- Pago: Valor compensado com sucesso. O saldo é disponibilizado na conta virtual do lojista conforme o prazo de liquidação do método de pagamento.
- Falhou: Cartão recusado (falta de limite, suspeita de fraude) ou Pix/Boleto não pago até o prazo de expiração estabelecido.
- Estornado: O lojista ou suporte solicitou a devolução dos fundos ao cliente.
- Contestado: Chargeback iniciado pelo portador do cartão alegando desconhecimento ou fraude comercial.
🕒 Prazos de Liquidação Financeira (Settlement)
O prazo para que o saldo de uma transação transite do Saldo Futuro para o Saldo Disponível varia de acordo com o método de pagamento utilizado:
| Método de Pagamento | Prazo de Liquidação (D+X) | Disponibilidade |
|---|---|---|
| Pix | D+0 (Instantâneo) | 🟢 Imediato (Segundos após a confirmação) |
| Boleto Bancário | D+1 (Dia Útil subsequente) | 🟡 Disponível no dia útil seguinte à liquidação |
| Cartão de Crédito (À Vista) | D+30 (Opção de antecipação ativa) | 🟡 Disponível em 30 dias a partir da venda |
| Cartão de Crédito (Parcelado) | D+30, D+60, D+90... | Lançamento mensal de parcelas na conta |
💸 Tarifas e Taxas da Plataforma
As tarifas aplicadas a cada transação são estabelecidas em seu contrato comercial e descontadas diretamente no momento da liquidação (Split de Taxa):
- Taxa Pix: Percentual fixo sobre o valor transacionado (ex:
0.99%, com tarifa mínima deR$ 0,50e máxima deR$ 9,90). - Taxa Boleto: Tarifa fixa cobrada exclusivamente por boleto pago/liquidado (ex:
R$ 2,49por boleto). Não há cobrança por emissão, alteração ou cancelamento de boletos. - Taxa Cartão de Crédito: Composta por taxa de processamento (ex:
3.99%à vista) + taxa por parcela adicional (ex:1.99%por parcela) + taxa de antecipação opcional se ativada.
🛡️ Chargebacks e Disputas (Cartão de Crédito)
O Chargeback ocorre quando o portador do cartão entra em contato com o banco emissor e contesta o lançamento em sua fatura:
Fluxo de Disputa:
- A operadora debita temporariamente o valor da transação da conta do lojista (Saldo de Reserva).
- O lojista recebe uma notificação via webhook/portal com o status
chargeback.created. - O lojista possui até 10 dias úteis para anexar documentos de defesa no portal (comprovantes de entrega, notas fiscais, logs de acesso ao serviço).
- A bandeira do cartão analisa os documentos enviados e emite a decisão final (vencida ou perdida) em até 45 dias.
🔄 Regras de Estorno e Reembolso (Refund)
- Prazo de Solicitação: O reembolso de uma transação confirmada pode ser solicitado em até 90 dias a partir da data de pagamento.
- Estorno Pix: Devolvido integral ou parcialmente direto para a conta de origem do pagador em segundos.
- Estorno Boleto: Requer o preenchimento dos dados bancários do pagador (Agência, Conta, CPF) no portal para transferência TED realizada em até 3 dias úteis.
- Estorno Cartão: Creditado na fatura do portador em até 2 ciclos subsequentes (regras de prazos das bandeiras).