Programas de Afiliados

Lance um programa de afiliados poderoso para impulsionar suas vendas. A stryhub suporta comissões flexíveis com pagamentos automáticos via Stripe Express — sem rastreamento ou pagamentos manuais.

Visão Geral

O sistema de afiliados da stryhub permite que você recrute parceiros que promovem seus produtos em troca de comissões. Quando um cliente compra através do link exclusivo de um afiliado, o afiliado recebe uma porcentagem da venda.

Principais recursos:

Estrutura flexível de comissões — Defina taxas personalizadas por produto e por afiliado
Pagamentos automáticos — Afiliados recebem comissões via Stripe Express
Rastreamento em tempo real — Cliques, conversões e ganhos rastreados instantaneamente
Links de indicação exclusivos — Cada afiliado recebe uma URL rastreável
Atribuição por cookie — Cookies primários garantem um rastreamento preciso

Criando um Programa de Afiliados

Para criar um programa de afiliados:

No painel administrativo, acesse Programa de Afiliados
Clique em Criar Programa (ou configure o existente)
Defina os detalhes do programa:
- Nome do programa: Exibido aos afiliados durante o registro
- Taxas de comissão: Defina a porcentagem padrão e personalize por produto
- Duração do cookie: Por quanto tempo os cookies de indicação duram (padrão: 30 dias)
Salve e ative o programa

Dica: Comece com taxas competitivas (15-30%) para atrair afiliados. Você pode ajustar as taxas depois sem afetar comissões já existentes.

Estrutura de Comissões

A stryhub suporta uma estrutura flexível de comissões com três camadas de configuração:

Camada	Descrição	Taxa Exemplo
Padrão do Programa	Taxa base de comissão aplicada a todos os produtos e afiliados	20%
Por Produto	Sobrescreva a taxa padrão para produtos ou preços específicos	15%
Por Afiliado	Defina taxas personalizadas para afiliados individuais em produtos específicos	25%

A taxa mais específica sempre prevalece: se um afiliado tem uma taxa personalizada para um produto, essa taxa é usada. Caso contrário, a taxa do produto é aplicada. Se nenhuma estiver definida, o padrão do programa é usado.

Você também pode escolher o tipo de comissão:

Recorrente: Afiliado ganha em cada renovação de assinatura
Única: Afiliado ganha apenas na compra inicial

Cálculo automático: A stryhub calcula as comissões automaticamente a cada venda. Sem rastreamento manual necessário.

Registro de Afiliados

Afiliados podem se registrar através de uma página de cadastro dedicada vinculada ao seu programa. O processo de registro:

Compartilhe o link de registro de afiliados com potenciais parceiros
Afiliados criam uma conta com e-mail e dados pessoais
Eles conectam uma conta Stripe Express para receber pagamentos
Após aprovação, recebem seu link de indicação exclusivo

Como administrador, você pode gerenciar afiliados pelo painel:

Visualizar todos os afiliados registrados
Ver o desempenho de cada afiliado (cliques, conversões, ganhos)
Gerenciar status do afiliado (ativo/inativo)

Rastreamento de Indicações

Quando um cliente clica no link de indicação de um afiliado, a stryhub:

Define um cookie primário no navegador do cliente
O cookie armazena o ID do afiliado e persiste pela duração configurada (padrão: 30 dias)
Quando o cliente conclui o checkout, o cookie é lido para atribuir a venda
As comissões são calculadas automaticamente para cada venda

Duração do cookie: Se um cliente clicar em múltiplos links de afiliados, o último clique determina a atribuição. Certifique-se de que a duração do cookie seja adequada ao seu ciclo de vendas.

Painel do Afiliado

Cada afiliado tem acesso a um painel dedicado que exibe:

Link de indicação exclusivo — Fácil de copiar e compartilhar
Estatísticas de cliques — Total de cliques, visitantes únicos
Dados de conversão — Número de vendas, taxa de conversão
Resumo de ganhos — Total ganho, pendente, pago
Histórico de pagamentos — Registro completo de todos os pagamentos
Links de indicação — URLs exclusivas de rastreamento para cada afiliado

Pagamentos

A stryhub gerencia os pagamentos de afiliados automaticamente através do Stripe Express. Nenhum trabalho manual é necessário — as comissões são calculadas e transferidas em tempo real.

Como funcionam os pagamentos

Um cliente compra através do link de indicação de um afiliado
O Stripe processa o pagamento e a comissão é calculada automaticamente
A comissão é transferida diretamente para a conta Stripe Express do afiliado via stripe.transfers.create()
A transferência é vinculada à cobrança original (source_transaction), então o Stripe libera os fundos somente quando o pagamento é compensado (2–30 dias dependendo do método de pagamento)
O afiliado recebe os fundos em sua conta bancária através do cronograma padrão de pagamentos do Stripe

Como o dinheiro flui

Veja o que acontece quando um cliente paga R$100 através de um link de afiliado (exemplo com 20% de comissão):

Dedução	Valor	Quem recebe
Taxa de processamento Stripe (3,99% + R$0,39)	R$4,38	Stripe
Taxa da plataforma stryhub (5%)	R$3,00	stryhub
Taxa de transferência (0,25% + R$0,25)	R$0,50	Cobre custo do Stripe Connect
Comissão do afiliado (20%)	R$20,00	Afiliado (via Stripe Express)
Valor líquido	R$72,12	Dono do programa (você)

Nota: A taxa da plataforma stryhub e a taxa de transferência estão incluídas no application_fee no momento do checkout. O dono do programa recebe o valor líquido diretamente em sua conta Stripe — sem cálculos manuais.

Stripe Express para afiliados

O Stripe Express oferece aos afiliados:

Onboarding fácil — Fluxo de registro simplificado gerenciado pelo Stripe
Depósitos bancários diretos — Os fundos vão diretamente para a conta bancária do afiliado
Documentação fiscal — O Stripe cuida dos relatórios fiscais
Suporte global — Disponível em mais de 40 países

Taxas e Custos

Existem três taxas separadas envolvidas quando afiliados recebem pagamentos. Entender cada uma garante total transparência.

1. Taxa da plataforma stryhub — 3% por transação

Esta é a taxa da stryhub, cobrada em cada transação processada pela plataforma. Ela é descontada automaticamente no momento do checkout via o application_fee do Stripe. Não há mensalidades ou planos de assinatura — você só paga quando ganha.

2. Taxas de processamento da Stripe

Estas são as taxas próprias da Stripe para processar cartões de crédito e outros métodos de pagamento. Elas são completamente separadas da taxa da stryhub e definidas pela Stripe:

Cartões domésticos: 3,99% + R$0,39
Cartões internacionais: 3,99% + R$0,39 + 2% adicional
PIX: 1,19%
Boleto: R$3,49

Para taxas atualizadas, consulte Preços da Stripe Brasil.

3. Taxas do Stripe Connect (pagamentos de afiliados)

A Stripe cobra taxas adicionais para transferir dinheiro para contas Express de afiliados:

Taxa	Valor	Como é tratada
Taxa por pagamento	0,25% + R$0,25	Já incluída no `application_fee` da transação no checkout. Nenhuma ação necessária.
Taxa de conta ativa	US$2,00/mês por conta Express ativa	Descontada da primeira transferência de comissão de cada mês do afiliado. Visível nos painéis do administrador e do afiliado.
Pagamentos instantâneos (opcional)	1,5% (mín. R$0,50)	Apenas se o afiliado escolher pagamento instantâneo para um cartão de débito.

Taxa de US$2/mês por conta ativa: A Stripe considera uma conta Express como "ativa" em qualquer mês em que um pagamento é enviado. Esta taxa de US$2 é repassada descontando-a da primeira comissão do afiliado naquele mês. Por exemplo, se um afiliado ganha uma comissão de R$50 e é o primeiro pagamento do mês, ele recebe aproximadamente R$38 (R$50 menos a taxa convertida). Todas as comissões subsequentes no mesmo mês são transferidas integralmente.

Para detalhes completos sobre preços do Stripe Connect, consulte Preços do Stripe Connect. Para a política completa de taxas da stryhub, veja nossos Termos de Serviço (Seção 5).

Testando a Configuração

Antes de ir para produção, verifique se o programa, os links de afiliado e o fluxo completo de pagamento estão funcionando corretamente. Use este checklist passo a passo:

1. Verifique se o link do afiliado está rastreando

No painel admin, vá em Programas e anote o ref_code de um afiliado de teste
Abra uma janela anônima/privada do navegador (para evitar cookies em cache)
Acesse uma página de produto ou link de checkout acrescentando o código: https://seu-site.com?ref=CODIGO_AFILIADO
Abra o DevTools do navegador (F12) → Application → Cookies
Você deve ver um cookie chamado affiliate_ref com o código do afiliado e uma data de expiração correspondente à duração configurada (padrão: 30 dias)

Como funciona o rastreamento: O script de tracking (tracking.js) lê o parâmetro ?ref= da URL e salva um cookie first-party. No checkout, a stryhub lê este cookie e atribui a venda ao afiliado. É utilizado last-click attribution — se o cliente clicar no link de outro afiliado depois, o cookie é sobrescrito.

2. Faça uma compra de teste

Com o cookie affiliate_ref ativo (do passo 1), prossiga para o checkout usando o Payment Link de um produto
Se estiver no modo de teste do Stripe, use o cartão 4242 4242 4242 4242 com qualquer data de validade futura
Conclua o pagamento

3. Verifique no painel admin

Após a compra, confira em quatro lugares no painel da stryhub:

Onde verificar	O que deve aparecer
Dashboard → Comissões Recentes	Uma nova entrada de comissão com o nome do afiliado, o valor da fatura, o valor da comissão e a taxa da plataforma
Afiliados → clique no afiliado	Uma nova indicação com status "active" vinculada ao e-mail do cliente e à assinatura
Transações	Uma nova transação com status "succeeded", mostrando valor bruto, taxa da plataforma, taxa Stripe e valor líquido
Webhooks → Logs	Entregas de webhook com status `200` (se você configurou um endpoint de webhook)

4. Verifique se o afiliado vê a comissão

Faça login como o afiliado de teste (ou peça para ele fazer login)
No painel do afiliado, ele deve ver:
- O total de ganhos atualizado
- A nova indicação em Indicações com status "active"
- Uma nova entrada em Comissões com o valor correto e status (pendente ou aprovada, dependendo do modo de aprovação)

5. Verifique o pagamento automático (se usar Stripe Express)

Se o afiliado conectou sua conta Stripe Express e o programa tem stripe_express_enabled = true:

Após a comissão ser aprovada (automática ou manualmente), um Transfer é criado automaticamente no Stripe
No seu Stripe Dashboard → Connect → Transfers, você deve ver a transferência para a conta Express do afiliado
O afiliado vê o pagamento no painel Stripe Express dele

Tudo funcionando? Se você vê a comissão no painel admin, a indicação vinculada ao afiliado, o webhook entregue com status 200 e o Transfer criado no Stripe — seu programa de afiliados está totalmente operacional. Pode começar a convidar afiliados reais para promover seus produtos.

Solução de Problemas

Problema	Causa provável	Solução
Cookie `affiliate_ref` não aparece	Script de tracking não carregado na página	Verifique se o `tracking.js` está embutido no seu site. Confira o console do navegador por erros.
Compra concluída mas nenhuma comissão criada	Cookie foi apagado ou expirou antes do checkout	Verifique se a duração do cookie é longa o suficiente (padrão 30 dias). O cliente precisa ter o cookie `affiliate_ref` no momento do checkout.
Comissão criada mas com valor errado	Nível de comissão configurado incorretamente	Confira a hierarquia: override por afiliado → comissão por produto → comissão padrão do programa. O mais específico tem prioridade.
Transfer não criado (comissão fica pendente)	Afiliado não conectou Stripe Express, ou o onboarding está incompleto	O afiliado precisa completar o onboarding do Stripe Express. Verifique o status `stripe_onboarded` do afiliado no painel admin.
Webhook não entregue	URL do endpoint está errada ou retornou status diferente de 2xx	Confira Webhooks → Logs para ver as tentativas de entrega e os códigos de erro. O signing secret deve corresponder ao que sua aplicação espera.