Comissões e ranks de parceiro

A comissão do parceiro é gerada automaticamente toda vez que um cliente indicado por você efetua um pagamento — seja a primeira assinatura, uma renovação mensal/anual, ou qualquer cobrança recorrente. Esse artigo explica o ciclo de vida de uma comissão, o sistema de ranks que define sua porcentagem, e como evoluir.

Pré-requisitos

• Conta de parceiro aprovada (status partner).
• Pelo menos 1 cliente indicado.

Status de uma comissão

Toda comissão passa por estados sequenciais:

Você acompanha o status na página Parceiro → Comissões ou nos KPIs do dashboard:

• Saldo a liberar = soma de comissões Pendente
• Saldo disponível = soma de comissões Disponível
• Saques realizados = soma de comissões Sacada (já recebida via PIX)

Como a comissão é calculada

Quando o cliente paga, o Syncro:

1. Identifica que o tenant tem referred_by_agency_id (vinculado a você).
2. Pega a % de comissão travada desse cliente (campo partner_commission_pct).
3. Calcula valor_pago × % comissão = valor da comissão.
4. Cria registro com status pending e available_at = hoje + 30 dias.

Por exemplo:

• Cliente paga R$ 297 (plano Growth mensal)
• Sua % travada nesse cliente é 30%
• Comissão gerada: R$ 89,10
• Disponível pra saque em: 30 dias

Por que existe a carência de 30 dias

Pagamentos podem ser estornados dentro de 30 dias por vários motivos:

• Chargeback no cartão
• Reclamação do cliente
• Fraude detectada

Pagar comissão antes desse prazo viraria pesadelo: comissão sacada e depois descobrindo que o pagamento original foi anulado. Então o Syncro mantém a comissão em carência até o pagamento ser considerado definitivo.

Após 30 dias sem estorno, a comissão é liberada automaticamente pra Disponível (cron diário partners:release-commissions às 06:30).

⚠️ Atenção: se um cliente estornar dentro do prazo, a comissão correspondente é cancelada. Se você já tinha sacado outras comissões disponíveis sem relação, elas continuam suas — o estorno não afeta saldo já pago.

Sistema de Ranks

Os ranks são níveis de progressão baseados na quantidade de clientes ativos indicados por você. Cada rank tem uma % de comissão maior:

💡 Os números acima são exemplo. Os ranks reais e %s específicos do programa Syncro são definidos pelo time e podem mudar — confira Parceiro → Dashboard pra ver seus ranks atuais.

Como subir de rank

Você sobe de rank automaticamente quando atinge o número mínimo de clientes ativos (count de tenants vinculados a você com status active ou partner).

Conta:

• ✅ Cliente em status Ativo ou Parceiro
• ❌ Cliente em Trial (ainda não pagou)
• ❌ Cliente em Suspenso (pagamento atrasado)
• ❌ Cliente em Inativo (desligado)

Quando algum cliente cancela, o count cai e você pode "voltar" pro rank anterior — mas a % travada nos clientes antigos continua a mesma.

% travada por cliente — explicação detalhada

Esse é o conceito mais importante de entender:

A % de comissão é definida no momento da PRIMEIRA COMPRA de cada cliente e fica travada pra aquele cliente pra sempre.

Exemplos:

• Caso A: Você está no Bronze (20%) quando o cliente X paga pela primeira vez. Cliente X gera 20% pra você pra sempre, mesmo se você subir pro Diamante mais tarde.
• Caso B: Você sobe pro Ouro (30%). Cliente Y entra agora — gera 30% pra você. Cliente X continua em 20%.
• Caso C: Você cai do Ouro pro Prata (count caiu). Cliente Z entra — gera 25%. Cliente Y continua em 30%, Cliente X continua em 20%.

A trava protege parceiros e clientes ao mesmo tempo:

• Parceiro não perde comissão dos clientes antigos se cair de rank.
• O programa fica previsível — não há mudança retroativa de %.

No dashboard

A página Parceiro → Dashboard mostra:

• Nível atual — seu rank no momento (com badge colorido)
• N vendas até o próximo nível — quanto falta pra subir
• Nível máximo atingido! — se você já está no rank topo

Histórico de comissões

Em Parceiro → Comissões, você vê a lista completa com filtros:

• Por status (Pendente / Disponível / Sacada / Cancelada)
• Por período (data de geração)
• Por cliente (procurar comissões de um cliente específico)

Cada linha mostra:

• Cliente que gerou a comissão
• Data do pagamento
• Valor pago pelo cliente
• % aplicada
• Valor da comissão pra você
• Status atual
• Data de liberação (quando vai sair da carência)

Quando o cliente cancela

Se um cliente seu cancela a assinatura:

• Comissões já em status Disponível ou Sacadas: ficam suas. Cancelamento futuro não retroage.
• Comissões em Pendente que não viraram disponíveis ainda: podem ser canceladas se a empresa pediu reembolso. Caso contrário, são liberadas normalmente após 30 dias.
• Cliente sai do count de Ativos: você pode "perder rank" se ficar abaixo do mínimo. Não afeta % dos clientes antigos.

Notificações

Você recebe notificações em vários momentos:

• Cliente novo cadastrado — alguém usou seu código
• Cliente fez primeira compra — comissão Pendente gerada
• Comissões liberadas — todo dia que o cron libera comissões da carência, você recebe email com o total liberado
• Saque processado — confirmação de PIX enviado

As notificações chegam por email e/ou no sino de notificações do painel.

Gerar relatório

Hoje a UI não tem exportação de relatório de comissões em CSV/Excel. Pra puxar tudo em formato planilha, contate suporte ou solicite via API (se sua conta tem acesso).

Limites e taxas

• Comissão mínima por geração: não há mínimo — qualquer pagamento gera comissão proporcional.
• % mínimo cobrado pelo Syncro: a % é configurada pelo time Syncro nos ranks. Você não tem como alterar.
• Limite de clientes: não há limite. Quanto mais clientes ativos, maior o ganho.

Próximo passo

Quando você tiver saldo disponível, veja Solicitar saque via PIX pra resgatar.

Artigos relacionados

• Programa de Parceiros — visão geral
• Como indicar um cliente
• Solicitar saque via PIX
• Materiais de apoio (downloads)