Afiliados - Administração

Resumo

Gestão do programa de afiliados: cadastro, aprovação, regras de comissão, bônus, cashback, saques, rastreamento de indicações, anti-fraude e pagamento. Cada afiliado tem link próprio, e comissões são calculadas automaticamente sobre faturas pagas.

Para quem é (papel/role)

• super-admin - programa global da plataforma.
• tenant-admin - programa do próprio tenant, quando habilitado.

O que você pode fazer

Afiliados

• Criar afiliado: cadastro manual de usuário como afiliado.
• Editar afiliado: alterar percentual, regras, dados de pagamento.
• Excluir afiliado.
• Listar afiliados: filtros por status, volume, data.

Comissões

• Listar comissões: pendentes, aprovadas, pagas.
• Aprovar comissão: muda status de pendente para aprovada.
• Pagar comissão: dispara pagamento ao afiliado (PIX/transferência/saldo).

Bônus

• Criar bônus: prêmio avulso por desempenho, campanha ou milestone.
• Aprovar bônus.
• Pagar bônus.

Cashback

• Aplicar cashback: credita cashback ao afiliado indicado ao cliente.

Como acessar

1. /admin.
2. Settings → Usuários → Afiliados ou /admin/settings/affiliates.

Tutoriais

Aprovar e pagar uma comissão

1. Acesse /admin/settings/affiliates e abra a aba Comissões.
2. Localize a comissão pendente.
3. Clique em Aprovar (/admin/settings/affiliates/commissions/{id}/approve).
4. Em seguida, clique em Pagar (/admin/settings/affiliates/commissions/{id}/pay).
5. Informe o método de pagamento e confirme.

Criar um bônus para campanha específica

1. Acesse /admin/settings/affiliates/bonuses/create.
2. Selecione o afiliado, descreva a campanha e informe o valor.
3. Aprove e pague pelos endpoints correspondentes.

Cadastrar um novo afiliado

1. Acesse /admin/settings/affiliates/create.
2. Selecione o usuário base, informe percentual e regras.
3. Salve. O link de afiliado é gerado automaticamente.

Integrações

• Usuários - afiliado é um usuário com role ampliado (gestao-de-usuarios.md).
• Billing - comissão calculada sobre faturas pagas (billing-gateways.md).
• Receita - comissão reduz receita líquida (receita-e-financeiro.md).
• Compliance - pagamentos a afiliados ficam em auditoria.
• Cupons - cupom pode ser atrelado a afiliado para atribuição (receita-e-financeiro.md).

Perguntas frequentes

Comissão é calculada no bruto ou líquido? Conforme configuração do programa. Por padrão, sobre o valor pago líquido de impostos.

Posso ter vários níveis (multinível)? O sistema suporta configuração escalonada. Confira as regras do plano.

Afiliado pode sacar quando quiser? Depende da regra de mínimo de saque e ciclo de pagamento configurado.

Como detectar fraude (autoafiliação)? O sistema bloqueia autoafiliação pelo mesmo usuário/e-mail; regras antifraude adicionais ficam em auditoria.

Posso ter percentuais diferentes por plano? Sim, configure a regra de comissão por plano.

Comissão é reversível em caso de reembolso? Sim. Reembolso de fatura gera estorno da comissão.

O link do afiliado expira? Não por padrão. Pode-se configurar campanha com validade.

Limitações, políticas e avisos

• Autoafiliação bloqueada.
• Pagamento de comissão exige gateway ou método configurado.
• Reembolso posterior gera estorno de comissão (emite evento).
• Tenant-admin vê somente afiliados do próprio tenant.

Relacionados

• users-management.md
• revenue-and-finance.md
• billing-gateways.md
• loyalty.md