Para equipe ilarika
Super Admin › Afiliados: aprovar, acompanhar e pagar quem indica
- Super AdminAfiliados (funil, lista, indicações a confirmar, pagamentos)
- Super AdminAfiliadosdetalhe
Afiliado é quem indica lojas para o Ilarika e ganha uma parte do que elas pagam. Aqui a equipe aprova cadastros, acompanha o funil, confirma indicações informadas no cadastro, gera o lote do mês e registra o Pix.
Como a indicação é registrada
- O afiliado divulga
parceiros.<domínio>/r/<código>. O clique grava um toque, um cookie de 60 dias no domínio e abre a página de parceiros com?ref=. Código inválido ou afiliado pausado: a página abre igual, sem cookie, e o toque fica marcado como inválido. - No checkout a atribuição segue a ordem cupom do afiliado → link/cookie → “quem indicou?” e é congelada na criação da assinatura. Não muda depois, nem se a loja usar outro cupom.
- Autoindicação (mesmo CPF/CNPJ, e-mail ou telefone da loja) não vale.
- “Quem indicou?” em texto livre vira uma indicação a confirmar: aparece na aba própria e só gera comissão depois que alguém confirma.
Comissão
- Só sobre fatura paga (nunca teste), descontado o excedente de IA.
- Taxa pela tabela: desde 27/10/2026, 10 % nos meses 1 a 12 da indicação e 0 do 13º em diante, em todas as categorias. O mês conta do primeiro pagamento da loja (meses-calendário), não do número de faturas: a fatura anual paga no 1º mês rende 10 % uma vez e a renovação (13º mês) não rende — antes, o anual pagaria a faixa de 50 % da 1ª fatura.
- A tabela fica em
PlatformSetting affiliates.rates(5 categorias × 4 faixas em pontos-base: 1º mês | 2º–6º | 7º–12º | 13º+). A migração20261027180000_planos_starter_essencial_pro_redegravou[1000, 1000, 1000, 0]em cada categoria; categoria que já tinha faixas próprias diferentes da tabela antiga (50/20/10) ficou como estava, e a auditoriaaffiliates.rates.v2diz quais. Para dar faixas próprias a uma categoria, edite só a linha dela (nunca crescente ao longo das faixas). - Nasce pendente por 30 dias (janela de reembolso). Reembolso ou chargeback revertem; cancelamento da loja nos primeiros 30 dias zera as pendentes. Comissão já paga e estornada vira um ajuste negativo no próximo lote.
- Antifraude: 5 indicações sem nenhuma fatura paga em 7 dias pausam o afiliado para revisão (o motivo aparece na lista).
A tela
Em cima, o funil dos últimos 30 dias: Cliques (30 d), Leads com código, Indicações, Lojas ativas indicadas e Comissões a pagar. Embaixo, três abas: Afiliados (lista com filtro por estado e busca por nome, e-mail, código ou documento), Indicações a confirmar e Pagamentos. No detalhe de um afiliado: Cadastro (tier, forma de pagamento, chave Pix, Mostrar selo, observações internas), indicações, comissões e lotes, e os botões Aprovar, Pausar, Reativar e Banir (todos pedem motivo; banido não volta).
Quem pode o quê
| Acesso à área Afiliados | Pode |
|---|---|
| Ver | Ver funil, lista, detalhe, extrato, lotes e baixar o CSV. |
| Ver e mudar (e o superadmin) | Aprovar, pausar, banir, mudar tier e forma de pagamento, confirmar indicações, aprovar comissões vencidas, gerar lote e marcar pago. (A tela não cadastra afiliado: o cadastro é pelo portal, pelo Indique e ganhe do painel ou do app do entregador; só a rota POST /platform/afiliados cria.) |
Passo a passo do mês
- Aprovar cadastros pendentes no detalhe (confira documento e chave
Pix). Dono de loja ativa e entregador verificado entram ativos sozinhos;
affiliates.autoApprove = trueaprova todo mundo na hora. - Depois do dia 1: em Pagamentos, escolha o Período (AAAA-MM)
anterior, toque em Aprovar comissões vencidas (o sistema também faz
isso de hora em hora) e em Gerar lote de <período>. Entram só afiliados ativos com saldo aprovado
acima do piso (
affiliates.minPayoutCents, padrão R$ 100). - Baixar CSV: nome, documento, chave Pix e valor. Faça os Pix.
- Marcar pago em cada lote com a Referência do Pix (id da transação). As comissões do lote viram pagas e o afiliado vê no extrato.
Perguntas comuns
A loja disse que foi indicada mas não aparece. Veja a aba Indicações a confirmar (Confirmar ou Rejeitar, com motivo). Se não está lá, a indicação não foi registrada no checkout e não dá para incluir depois (a atribuição é congelada); anote no cadastro do afiliado se for o caso de um ajuste manual.
O afiliado quer mudar a chave Pix. No detalhe, Chave Pix, Salvar (ou ele mesmo, em Pagamento no portal: comissões e pagamento). O lote já gerado guarda a chave da época; confira antes de pagar.
