Afiliados

Resumo

O Programa de Afiliados permite que o usuário indique novos cadastros e receba comissões, bônus e cashback conforme regras configuradas pelo admin. A área do usuário fica em /dashboard/affiliates e na tab Afiliados do perfil (app/User/Views/profile/tabs/affiliates.php). O admin gerencia em /admin/settings/users/affiliates*.

Para quem é (personas)

• Usuário comum que deseja virar afiliado.
• Afiliado ativo que acompanha indicações, comissões e solicita saque.
• Admin de afiliados que cadastra regras, aprova saques e controla fraudes.

O que você pode fazer

Ativar programa (self-service)

• Virar afiliado: POST /dashboard/affiliates/activate — ativa a conta

como afiliado (se o programa estiver aberto no tenant).

Links de Indicação

• Link pessoal gerado automaticamente (ex: /register?ref=MEUCOD).
• QR Code do link: GET /api/profile/affiliate/qrcode.

Acompanhamento

• Dashboard de afiliados: GET /dashboard/affiliates.
• Total de cliques, cadastros, conversões.
• Saldo disponível, pendente e pago.
• Árvore de indicações (quando multinível).
• Comissões por venda.

Saque

• Solicitar saque: POST /dashboard/affiliates/withdraw.
• Métodos de pagamento conforme configuração do admin (PIX, transferência,

cupom interno, wallet).

Administração

Controllers em app/Admin/Controllers/Affiliates/:

• AffiliatesController — cadastro, aprovação, listagem.
• AffiliateCommissionsController — regras de comissão.
• AffiliateBonusesController — bônus especiais.
• AffiliateCashbackController — cashback por compra.

Views em app/Admin/Views/settings/users/:

• affiliates.php, affiliates-commissions.php, affiliates-bonuses.php,

affiliates-cashback.php.

Como acessar

1. Faça login.
2. Acesse /dashboard/affiliates (painel completo) ou

/dashboard/profile?tab=affiliates (resumo e link).

Tutoriais

Virar afiliado

Objetivo: Ativar sua conta no programa.

Passos:

1. Acesse /dashboard/profile?tab=affiliates.
2. Clique em Quero ser afiliado.
3. Aceite termos do programa.
4. Aguarde ativação (imediata ou por aprovação do admin).

Compartilhar link de indicação

Objetivo: Divulgar seu código e gerar comissões.

Passos:

1. Em /dashboard/affiliates, copie seu link pessoal.
2. Compartilhe em redes, WhatsApp, email.
3. Ou baixe o QR Code via /api/profile/affiliate/qrcode.

Solicitar saque

Objetivo: Retirar saldo acumulado.

Passos:

1. Em /dashboard/affiliates, veja Saldo disponível.
2. Clique em Solicitar saque.
3. Escolha método (PIX, transferência, wallet interna).
4. Confirme (/dashboard/affiliates/withdraw).
5. Aguarde aprovação do admin (geralmente em dias úteis).

Integrações

• Cadastro: /api/register/validate-referral valida códigos.
• Wallet: saques podem ir direto para a carteira interna.
• Event Bus: eventos de conversão disparam cálculo de comissão.
• Cupons: afiliados podem ter cupons próprios associados.

Perguntas frequentes

Qual a comissão que recebo? Depende das regras configuradas pelo admin — pode ser percentual, valor fixo, recorrente ou única.

Posso indicar a mim mesmo? Não. O sistema valida e bloqueia auto-indicações.

Quando recebo a comissão? Após a conversão confirmada (pagamento da indicação). Saques seguem SLA configurado (ex.: 30 dias pós-venda).

Perdi uma venda. Como reclamar? Abra ticket em /dashboard/support com o link/código usado. A auditoria verifica o tracking.

Posso ter afiliados abaixo de mim (multinível)? Se o admin habilitou MLM, sim. O painel mostra a árvore de indicações.

O que é cashback? Desconto devolvido ao próprio comprador (diferente de comissão que vai ao afiliado). Configurado em affiliates-cashback.php.

Como vejo quem indiquei? Em /dashboard/affiliates, seção Minhas indicações.

O link de indicação expira? Por padrão, não. Fica vinculado à conta enquanto o afiliado estiver ativo.

Limitações e políticas

• Antifraude: cliques e cadastros passam por validação (IP, fingerprint).
• Auto-indicação bloqueada automaticamente.
• Saque mínimo definido pelo admin.
• Retenção fiscal aplicada quando configurada.
• Cancelamento de comissão se a venda original for estornada.

Relacionados

• Meu Perfil
• Carteira e Transações
• Pagamentos e Billing