Pular para o conteúdo

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

  1. 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.
  2. 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.
  3. Autoindicação (mesmo CPF/CNPJ, e-mail ou telefone da loja) não vale.
  4. “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ção 20261027180000_planos_starter_essencial_pro_rede gravou [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 auditoria affiliates.rates.v2 diz 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

  1. Aprovar cadastros pendentes no detalhe (confira documento e chave Pix). Dono de loja ativa e entregador verificado entram ativos sozinhos; affiliates.autoApprove = true aprova todo mundo na hora.
  2. 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).
  3. Baixar CSV: nome, documento, chave Pix e valor. Faça os Pix.
  4. 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.