Afiliados - Visão Geral do Programa

O que é

A página Programa de Afiliados é o painel onde você acompanha o seu próprio programa de indicação do Viagilize. Cada empresa que assinar o Viagilize a partir do link de indicação gera comissão recorrente sobre a mensalidade enquanto o indicado permanecer ativo.

O usuário normalmente chega aqui para copiar o link de indicação, compartilhar nas redes sociais, acompanhar quantas indicações já viraram clientes ativos, conferir o saldo disponível e resgatar - abatendo da própria mensalidade ou recebendo em dinheiro via PIX. A conta de afiliado é criada automaticamente no primeiro acesso, então não há cadastro prévio.

Como usar

1. No menu lateral, clique em Afiliados.
2. No card azul/ciano do topo (Seu Link de Indicação), clique em Copiar Link para copiar a URL para a área de transferência. O botão mostra Copiado! por 2 segundos como confirmação.
3. Logo abaixo, em Compartilhar via, escolha o canal: WhatsApp, Telegram, Facebook, LinkedIn, X/Twitter ou E-mail. Cada botão abre o app/site correspondente com mensagem pronta e o seu link.
4. Acompanhe os indicadores nos 4 cards de estatísticas:
   • Indicações - total de cadastros vinculados ao link.
   • Ativos - indicados que já converteram (assinatura ativa).
   • Saldo - valor disponível para resgate agora.
   • Total Ganho - soma histórica de tudo que o programa já gerou.
5. No card Performance este mês confira Cliques no link, Conversões, Taxa de conversão, Comissões este mês e a comparação com o Mês passado.
6. Para resgatar, use o card Resgatar Comissões (coluna direita):
   • Selecione Abater da mensalidade para aplicar como crédito na próxima fatura, ou Receber em dinheiro para receber via PIX em até 48h úteis.
   • Se escolher Receber em dinheiro, o sistema usa a chave PIX cadastrada em Configurações de Pagamentos.
   • Clique em Aplicar Crédito de R$ ... ou Solicitar Saque de R$ ... conforme a opção escolhida.
7. Role a página para conferir as tabelas Últimas Indicações, Comissões Recentes e Histórico de Saques (as duas últimas só aparecem quando há registros).

Casos especiais

Saldo abaixo do mínimo

Se o saldo pendente ainda não atingiu o valor mínimo configurado, o card Resgatar Comissões mostra o ícone de cofrinho, a mensagem Saldo insuficiente para saque e o Mínimo: R$ ... que falta acumular. Nenhum botão de resgate é exibido nesse estado.

Resgate em PIX sem chave cadastrada

Quando o usuário marca Receber em dinheiro sem ter chave PIX salva na sua empresa, aparece um aviso amarelo dentro do card Resgatar Comissões com o link Ir para Configurações de Pagamentos. O botão Solicitar Saque fica desabilitado até a chave ser cadastrada. Após cadastrar, o card passa a mostrar a chave mascarada e o nome do beneficiário, e o botão é liberado.

Aplicar saldo como crédito na mensalidade

Ao escolher Abater da mensalidade, o valor pendente é zerado no perfil de afiliado e somado ao campo affiliate_credit da sua empresa, sendo descontado automaticamente na próxima fatura. Se a mensalidade do plano for maior ou igual ao saldo, o sistema mostra a frase Saldo cobre a mensalidade! dentro da caixa verde de aviso.

Status das indicações

Cada linha em Últimas Indicações mostra um selo de status:

• Ativo (verde) - indicado já pagou e gera comissão.
• Aguardando pagamento (amarelo) - cadastro feito, mas ainda sem confirmação financeira.
• Cancelado (vermelho) - indicação invalidada (cancelamento/devolução).

Status das comissões e saques

Comissões Recentes usa quatro status: Pago (verde), Confirmado (esmeralda), Aguardando confirmação (âmbar) e Cancelado (cinza). Histórico de Saques mostra Pago, Processando ou Pendente com a forma de pagamento (PIX ou Transferência) e a data de solicitação.

Erros comuns e como resolver

• "Você não tem uma conta de afiliado." - Causa: você ainda não tem registro em affiliates (situação rara, pois a conta é criada no primeiro acesso). Solução: recarregar a página /admin/afiliados para o sistema chamar ensureTenantHasAffiliate e provisionar o registro.
• "Não foi possível solicitar o saque. Verifique se você atingiu o valor mínimo e tem os dados de pagamento configurados." - Causa: saldo abaixo do mínimo, sem nenhuma comissão aprovada/paga ainda, ou chave PIX vazia. Solução: aguardar mais comissões confirmarem ou cadastrar a chave PIX em Configurações de Pagamentos.
• "Saldo insuficiente para aplicar crédito." - Causa: o saldo pendente está zerado ou abaixo do mínimo no momento do clique. Solução: aguardar novas comissões serem aprovadas antes de tentar novamente.
• Botão de saque desabilitado - Causa: opção Receber em dinheiro marcada sem chave PIX cadastrada. Solução: clicar em Ir para Configurações de Pagamentos e preencher a chave PIX, depois voltar à página.

Onde encontrar

• URL: /admin/afiliados
• Caminho no menu: Afiliados (item fixo do sidebar)
• Permissão necessária: nenhuma específica - qualquer usuário com acesso ao admin acessa
• Módulo necessário: nenhum (item fixo, disponível em todos os planos)

Veja também

• Compartilhar o link de indicação
• Comissões e Saques