Faturamento - Carteira de Créditos

O que é

A Carteira de Créditos é o saldo da sua conta no Viagilize que será abatido automaticamente das próximas cobranças da assinatura. Esse saldo é exibido como um card destacado na página Plano Atual com o título Saldo da Carteira e a descrição "Crédito de comissões de afiliados para abater em cobranças".

Hoje a carteira é alimentada exclusivamente pelo programa de afiliados: quando você acumula comissões em Afiliados e escolhe a opção Abater da mensalidade em vez de sacar em dinheiro, o valor sai do saldo de afiliado e vai para a sua carteira. Ele permanece guardado até ser descontado nas próximas faturas (mensalidade do plano e módulos adicionais).

Como usar

A carteira não tem botão de uso - o desconto é automático. O fluxo completo do ponto de vista do usuário é:

1. Vá em Afiliados no menu lateral e acumule comissões a partir das indicações.
2. Clique em Solicitar Saque dentro da página de Afiliados e escolha Abater da mensalidade. O valor sai do saldo de afiliado e entra na carteira da sua empresa.
3. Volte para Plano Atual (/admin/billing). O card verde Saldo da Carteira mostra o valor disponível, formatado em reais, com a mensagem "Será aplicado automaticamente na próxima cobrança".
4. Na próxima fatura (mensalidade + módulos), o saldo é descontado antes da geração do PIX ou do envio para o cartão.

Não é preciso digitar valor, marcar checkbox ou clicar em "aplicar" - quando há saldo, ele é considerado no cálculo da próxima cobrança automaticamente.

Casos especiais

Saldo maior que o valor da mensalidade

Se o saldo da carteira for maior ou igual ao valor da mensalidade do plano, a fatura do mês é coberta integralmente e o valor restante permanece na carteira para o ciclo seguinte. Em Afiliados, no momento de escolher Abater da mensalidade, o sistema mostra o aviso Saldo cobre a mensalidade! para sinalizar essa situação.

Saldo menor que o valor da mensalidade

Quando o saldo é menor que a fatura, o valor é abatido parcialmente e você paga somente a diferença pelo método escolhido (PIX ou cartão) na página Plano Atual.

Carteira não aparece no card

O card Saldo da Carteira só é renderizado quando o valor é maior que zero. Saldo zerado ou negativo (situação que não deveria existir) faz o bloco ficar oculto. Isso é normal - não significa erro.

Carteira só comporta crédito de afiliados

Atualmente não existe lançamento manual de crédito, bônus promocional ou crédito por cancelamento de assinatura. Toda entrada na carteira parte da opção Abater da mensalidade dentro de Afiliados. Reembolsos administrativos eventuais são tratados em outros campos (ajuste proporcional na fatura) e não passam pela carteira.

Erros comuns e como resolver

• "O saldo apareceu em Afiliados mas não aparece em Plano Atual" - Causa: você ainda não confirmou a opção Abater da mensalidade. O saldo só migra para a carteira após essa confirmação. Solução: vá em Afiliados, clique em Solicitar Saque e escolha Abater da mensalidade.
• "Paguei o PIX cheio mas tinha saldo na carteira" - Causa: o desconto é aplicado no momento de gerar a próxima cobrança. Se o PIX já estava pendente quando o crédito entrou, ele mantém o valor original. Solução: aguarde a próxima geração de cobrança, o saldo continua disponível para o próximo ciclo.
• "Saldo insuficiente para aplicar crédito." - Mensagem exibida em Afiliados ao tentar abater na mensalidade sem ter atingido o saldo mínimo de saque. Solução: acumule mais comissões até o mínimo de saque ou escolha receber em dinheiro quando disponível.

Onde encontrar

• URL: /admin/billing - card Saldo da Carteira aparece dentro dessa página
• Caminho no menu: Plano Atual
• Permissão necessária: nenhuma específica (qualquer usuário com acesso ao Plano Atual visualiza o card)
• Módulo necessário: nenhum
• Origem do saldo: Afiliados > Solicitar Saque > Abater da mensalidade

Veja também

• Visão Geral do Faturamento
• Formas de Pagamento
• Comissões e Saques (Afiliados)