Por trás dos afiliados: como funciona o sistema de cupons da thMenu

Um código como "AHMET5" parece trivial, mas atrás dele estão a API de cupons da Stripe, webhooks idempotentes e um livro-razão de comissões. Aqui descrevemos a mecânica real do programa de afiliados da thMenu.

O que acontece no signup

Ao se cadastrar, o backend cria um cupom único na Stripe. Código derivado do seu nome (ex. "AHMET5"), 5% para sempre, e affiliate_id nos metadados. Um promo code é publicado para aparecer no Checkout.

O cupom é vinculado ao seu perfil. Assim que um cliente Stripe aplica, começa a atribuição vitalícia — mesmo se o café trocar de plano três anos depois, o vínculo permanece.

Cálculo da comissão

O café escolhe o plano Pro a $29. Após o desconto paga cerca de $24 líquidos. O webhook invoice.payment_succeeded chega ao worker, idempotência é reivindicada e uma linha entra em affiliate_commissions.

Sua parte: 20% do líquido = $4,80/mês. Vitalício sobre MRR, com drip em 12 meses nos planos anuais para suavizar reembolsos.

Matemática win-win

Três partes ganham: o café economiza $52/ano, o afiliado ganha $58/ano por café ativo, thMenu reduz CAC bem abaixo da aquisição paga.

• Café: 5% para sempre, sem burocracia extra
• Afiliado: $4,80/mês por café com clawback em reembolso
• thMenu: CAC baixo, LTV saudável

FAQ

Posso renomear o código? Não, ele é permanente para manter consistência.

E se o café cancelar? Comissão para nesse mês. Reembolsos disparam clawback automático.

Usar meu próprio cupom? Não — anomaly detection marca self-purchase e anula a comissão.

Achou útil? Compartilhe.