Como montar um programa de afiliados na Stripe (com comissões recorrentes e reembolsos)

A Stripe não tem um recurso nativo de programa de afiliados. Ela cobra o cliente, mas não cria links de indicação, não lembra quem mandou cada visitante e não calcula comissões. Para rodar um programa de afiliados na Stripe, você adiciona uma camada de rastreamento que liga cada pagamento da Stripe ao afiliado que o gerou.

Conferimos isso na documentação da própria Stripe em outubro de 2026. O que a Stripe oferece são blocos de construção: um campo client_reference_id no Checkout, metadados nos seus objetos e eventos de webhook para cada fatura paga e cada reembolso. São úteis, e nenhum deles é um sistema de comissões.

Este guia mostra como as peças se conectam, evento por evento: o clique, o checkout, cada renovação e cada reembolso. Ele também cobre as cinco regras que você precisa definir antes do primeiro afiliado e o ponto em que construir tudo sozinho deixa de fazer sentido.

A Stripe tem um recurso nativo de programa de afiliados?

Não. Em outubro de 2026, a documentação da Stripe não descreve nenhum recurso que gere links de afiliado, rastreie visitantes indicados ou calcule comissões. O rastreamento de afiliados na Stripe roda por apps de terceiros ou pelo seu próprio código, em cima de campos que a Stripe criou para conciliação, como client_reference_id e metadados.

A peça nativa mais próxima é o client_reference_id. Na API de Checkout Session, a Stripe o define como "a unique string to reference the Checkout Session" (uma string única para referenciar a Checkout Session), com tamanho máximo de 200 caracteres. Nos Payment Links, você pode adicioná-lo à URL, e a Stripe o devolve no webhook checkout.session.completed.

Isso dá a você um lugar para levar um código de afiliado até o pagamento. Todo o resto (o cookie, a regra de atribuição, a conta da comissão, o estorno no reembolso) fica por sua conta: construir ou comprar. É exatamente por isso que o Stripe App Marketplace lista vários apps de afiliados.

Procurando o programa de afiliados da própria Stripe?

Parte das buscas por "stripe affiliate program" vem de quem quer ganhar dinheiro indicando empresas para a Stripe. Esse é outro programa: a Stripe paga afiliados de marketing por leads qualificados conforme seus Affiliate Terms (atualizados pela última vez em 28 de fevereiro de 2022), operados por uma plataforma de parceiros terceirizada. Este guia trata do caminho inverso: pagar os seus afiliados pelos clientes que eles mandam para o seu produto cobrado pela Stripe.

Como funciona o rastreamento de afiliados na Stripe?

O rastreamento de afiliados na Stripe conecta três momentos: o clique, o checkout e cada pagamento depois dele. O clique guarda o código do afiliado. O checkout leva esse código para dentro da Stripe. Cada pagamento seguinte é associado ao mesmo cliente da Stripe, então a comissão acompanha a assinatura, e não o navegador.

Na prática, são cinco etapas:

1. O clique. Um afiliado compartilha um link como yoursite.com/?ref=jane. Um script no seu site lê o ref e o guarda em um cookie first-party pelo tempo da sua janela de cookie.
2. O checkout. Quando o visitante compra, o código entra na Stripe: como client_reference_id na Checkout Session ou no Payment Link, ou como metadado no cliente ou na assinatura.
3. O vínculo. Quando chega o checkout.session.completed, você registra "o cliente da Stripe cus_... pertence à Jane". A partir daí, o cliente carrega a atribuição.
4. As renovações. Cada período de assinatura pago dispara invoice.paid. Você busca o cliente, encontra a Jane e adiciona uma comissão se a fatura ainda estiver dentro do seu período de comissão.
5. Os reembolsos. Um reembolso total ou parcial dispara charge.refunded. Você estorna ou reduz a comissão ligada àquela cobrança.

Por que o afiliado deve ficar no cliente da Stripe, e não no cookie

Cookie é um lugar frágil para guardar atribuição. Desde o ITP 2.1, o Safari limita a sete dias a validade de todo cookie persistente criado via document.cookie (WebKit, fevereiro de 2019). Uma janela de cookie de 30 dias definida por JavaScript pode virar, sem aviso, sete dias para quem visita pelo Safari.

A solução é tirar o código do navegador o quanto antes: levá-lo para o seu registro de cadastro e para a Stripe no checkout. Depois que o código da Jane está no cliente da Stripe, uma renovação no 11º mês não depende de nenhum cookie ainda existir.

Veja como cada evento da Stripe deve alterar o saldo do afiliado (webhooks de assinatura da Stripe):

O que você precisa decidir antes do primeiro afiliado?

Defina cinco regras antes que alguém comece a divulgar você: taxa de comissão, duração da comissão, janela de cookie, regra de reembolso e período de carência. Coloque tudo nos seus termos de afiliado desde o primeiro dia. Mudar essas regras depois que os afiliados começam a mandar tráfego custa mais confiança do que qualquer ajuste de taxa economiza.

Aqui vai a conta com um exemplo, com números escolhidos para ilustrar, não como referência de mercado. Um plano de US$ 49/mês paga 20% recorrente por 12 meses. Cada fatura paga gera US$ 9,80, então o teto por cliente é de US$ 117,60.

Se o cliente for reembolsado no terceiro mês, aqueles US$ 9,80 são estornados. Se ele cancelar depois do quinto mês, o afiliado ganhou US$ 49,00 no total e não há mais nada a pagar.

Passe o seu próprio plano pela mesma conta antes de escolher uma taxa. O guia passo a passo para começar um programa de afiliados cobre o resto do lançamento: termos, recrutamento e o que medir.

Como funcionam comissões recorrentes e reembolsos em assinaturas da Stripe?

Em uma assinatura da Stripe, cada período de cobrança gera uma fatura, e a Stripe envia invoice.paid quando ela é paga. Uma comissão recorrente é uma comissão por fatura paga, pelo tempo que as suas regras permitirem. Um reembolso envia charge.refunded, e a comissão ligada àquela cobrança deve ser estornada junto.

Quatro casos derrubam a maioria das soluções caseiras:

• Upgrades e downgrades. A Stripe dispara customer.subscription.updated nas trocas de plano. Calcule a comissão sobre o valor de cada fatura paga, não sobre o preço do plano original.
• Pagamentos que falham. Pague comissão no invoice.paid, nunca no invoice.created. Uma fatura criada e nunca paga não gera nada.
• Testes grátis. O checkout é concluído quando o teste começa, então o vínculo é salvo antes da primeira cobrança. A primeira comissão chega com a primeira fatura paga, mesmo semanas depois.
• Reembolsos parciais. Se você reembolsar metade de uma fatura de US$ 49, reduza pela metade a comissão daquele período. Um estorno total em um reembolso parcial deixa o afiliado no prejuízo.

Vale construir o rastreamento de afiliados na Stripe sozinho ou usar uma ferramenta?

Construa sozinho se você tem um ou dois parceiros em quem já confia e um dev com uma tarde livre. O rastreamento é a parte fácil: um script de cookie, o client_reference_id e um handler de webhook. Use uma ferramenta quando desconhecidos forem divulgar você, porque é no trabalho depois do rastreamento que os programas caseiros quebram.

Um programa que funciona precisa de mais do que atribuição:

• Uma página de cadastro onde os afiliados se inscrevem, e um jeito de aprovar ou recusar cada um
• Um painel onde cada afiliado vê cliques, conversões e ganhos pendentes
• Um livro-razão de comissões que lida com estornos, reembolsos parciais e períodos de carência
• Um fechamento mensal que registra quem recebeu, quanto e quando

Quando uma ferramenta é exagero: se o seu programa inteiro é uma agência com uma taxa fixa por indicação, uma planilha e um cupom da Stripe bastam.

Se você está comparando ferramentas pelo custo, nossa análise de alternativas ao Tapfiliate faz as contas em diferentes volumes de vendas. E se você ainda está escolhendo entre um programa de indicação de clientes e um programa de afiliados, comece por programa de indicação vs programa de afiliados para SaaS.

Como montar um programa de afiliados na Stripe com a PartnerBee

A PartnerBee se conecta à Stripe e rastreia checkouts e assinaturas automaticamente, incluindo comissões recorrentes e reembolsos. Os afiliados recebem um link como yoursite.com/?ref=code; um snippet curto de JavaScript registra o clique e guarda a indicação em um cookie first-party (ba_aff), dentro da janela de cookie que você escolhe para cada programa.

A configuração segue as mesmas cinco etapas da solução sob medida:

1. Crie um programa. Defina a comissão (única ou recorrente), a janela de cookie e a página de cadastro. Escolha entre aprovação automática ou revisar cada inscrição.

2. Conecte a Stripe. Em Integrações, a PartnerBee fornece uma URL de webhook (https://api.partnerbee.app/webhooks/stripe/...). Adicione essa URL como endpoint de webhook na sua conta Stripe e cole de volta na PartnerBee o signing secret da Stripe (whsec_...). A PartnerBee verifica cada evento, lê a indicação do afiliado nos metadados do pagamento e registra a venda. Funciona com a sua conta Stripe atual.

3. Adicione o snippet ao seu site. Cole em todas as páginas do seu funil, antes de </body>. O bee('detect') lê o ?ref= da URL, registra o clique e grava o cookie ba_aff:

   <script>
     (function(w,d,s,o){
       w.bee=w.bee||function(){(w.bee.q=w.bee.q||[]).push(arguments)};
       var j=d.createElement(s);j.async=true;
       j.src="https://script.partnerbee.app/beeaffiliate.js";
       d.head.appendChild(j);
     })(window,document,"script");
     bee('create', { integration: 'stripe' });
     bee('detect');
   </script>
   

   Se o seu app fica em um subdomínio diferente do site de marketing, repasse o ?ref= na URL de cadastro para que o cookie possa ser gravado de novo lá.

4. Compartilhe a página de cadastro. Ela fica hospedada em join.partnerbee.app, ou no seu próprio domínio com white label.

5. Aprove e liquide. As conversões chegam com o afiliado já vinculado. Você aprova as comissões e liquida os saldos em um único lote. O pagamento em si sai pelo seu próprio método; a PartnerBee registra a liquidação e o fechamento mensal.

Nem toda venda passa pelo Stripe Checkout. Para um checkout próprio ou uma assinatura que você mesmo cobra, a API REST faz o mesmo trabalho a partir do seu backend. Registre o cliente uma vez no cadastro, atribuído pelo valor do cookie ba_aff, e depois informe cada cobrança pelo id do cliente. As renovações são creditadas ao afiliado original sem nenhum clique novo:

curl -X POST https://api.partnerbee.app/api/customers \
  -H "Authorization: beeaff-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "customer_id": "cus_123", "cookie_id": "<ba_aff value>", "status": "trial" }'

curl -X POST https://api.partnerbee.app/api/conversions \
  -H "Authorization: beeaff-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "customer_id": "cus_123", "external_id": "invoice_88", "amount": 49.90 }'

O external_id torna cada cobrança idempotente, então um webhook reenviado nunca conta duas vezes. Quando um cliente passa da janela de comissão do programa, as cobranças seguintes deixam de gerar comissão. A referência completa está na documentação para desenvolvedores da PartnerBee.

Os webhooks enviam conversões, aprovações e pagamentos para os seus próprios sistemas assim que acontecem. A Stripe não é obrigatória: Asaas, Vindi, Guru, a API e o snippet funcionam sem ela.

Quanto custa, em outubro de 2026: US$ 6,99 por ciclo de 30 dias, mais 2% das vendas rastreadas por afiliados até US$ 10.000 por ciclo (1,5% de US$ 10.000 a US$ 50.000 e 1% acima disso). A taxa é 0% sobre os primeiros US$ 1.000 em vendas rastreadas por afiliados, uma única vez, e vendas orgânicas nunca são cobradas.

Um primeiro ciclo com US$ 3.000 em vendas de afiliados custa US$ 6,99 + 2% de US$ 2.000 = US$ 46,99. O ciclo seguinte de US$ 3.000 custa US$ 6,99 + US$ 60 = US$ 66,99.

FAQ

Dá para rastrear afiliados com os Payment Links da Stripe?

Sim. Adicione o client_reference_id à URL do Payment Link e a Stripe o devolve no webhook checkout.session.completed. O valor aceita só letras, números, hífens e underscores, com até 200 caracteres. A Stripe descarta valores inválidos sem avisar, então teste com os seus códigos de afiliado reais antes do lançamento.

A Stripe calcula ou paga comissões de afiliados?

Não. A Stripe processa os pagamentos dos seus clientes e envia eventos, mas não tem nenhuma lógica de comissão. A sua ferramenta de rastreamento ou o seu próprio código transforma os eventos invoice.paid e charge.refunded em saldos de comissão. Pagar os afiliados é uma etapa separada, feita pelo seu próprio método de pagamento.

Afiliados ganham comissão nas renovações de assinaturas da Stripe?

Só se o seu programa pagar comissão recorrente. Com regras recorrentes, cada fatura de renovação paga gera uma comissão até o fim do período que você definiu, por exemplo 12 meses. Com regras de comissão única, só a primeira fatura paga conta. Renovações que falham ou são reembolsadas não devem gerar nada.

Qual deve ser o tamanho da janela de cookie?

Ajuste ao tempo que os seus compradores levam para decidir. Confira no seu próprio analytics o intervalo entre a primeira visita e o cadastro pago e defina uma janela que cubra a maior parte dele. Lembre que o Safari limita cookies de JavaScript a sete dias, então salve o código do afiliado no cadastro.

A Stripe movimenta o dinheiro; o seu programa de afiliados precisa da memória

Um programa de afiliados na Stripe funciona quando o código do afiliado chega ao cliente da Stripe no checkout, cada invoice.paid adiciona uma comissão dentro das suas regras e cada charge.refunded retira uma. Defina taxa, duração, janela de cookie, regra de reembolso e período de carência antes que o primeiro afiliado se cadastre.

A PartnerBee faz essa ligação por você: rastreamento nativo da Stripe para checkouts e assinaturas, comissões recorrentes que são estornadas no reembolso e um fechamento mensal que registra cada liquidação. Custa US$ 6,99 por ciclo de 30 dias, mais uma taxa apenas sobre as vendas rastreadas por afiliados.

Comece agora: conecte a Stripe, defina sua comissão e sua janela de cookie e pague 0% sobre os primeiros US$ 1.000 em vendas rastreadas por afiliados.

Vitor Rocha · 7 de outubro de 2026 · Tempo de leitura: 9 minutos

Publicado em 7 de outubro de 2026