Programa de criadores com código promocional no Stripe, sem código
No Stripe, o cupom do criador é um código promocional (promotion code). Crie um por criador com o código dele, cadastre o webhook do criador.studio e uma chave restrita só de leitura: cada Checkout pago ou fatura de assinatura com o código vira comissão, e o reembolso tira ela. Venda em dólar entra pela PTAX do dia.
Atualizado emO que chega sozinho
- Compra aprovada com o cupom de um criador: vira venda, com a comissão na carência.
- Reembolso total: a comissão sai do mês. Se já tinha sido paga, sai do próximo Pix do criador.
- Venda sem cupom, ou com um cupom que não é de criador: fica de fora, sem comissão pra ninguém.
- Produto do Stripe ainda não ligado a um produto seu: a venda espera e entra quando você ligar.
Passo a passo
- 1No criador.studio, abra Integração › Onde você vende? › Stripe. O painel mostra o endereço da sua marca:criador.studio/api/hooks/stripe/••••••••
- 2No Stripe, abra Desenvolvedores › Webhooks (Workbench) e clique em Adicionar destino.
- 3Escolha Sua conta e marque estes eventos:
checkout.session.completedcheckout.session.async_payment_succeededinvoice.paidcharge.refunded - 4Escolha Endpoint de webhook e cole o endereço acima no campo URL.
- 5De volta ao painel: Na página do destino, copie o Segredo da assinatura (começa com
whsec_). Pra lermos o código que o cliente digitou, crie também uma chave restrita em Desenvolvedores › Chaves de API, só com leitura de Sessões do Checkout, Faturas e Códigos promocionais, e cole aqui.
O cupom de cada criador
No Stripe, o que o cliente digita é o código promocional (Promotion code). Crie um por criador com exatamente o código dele aqui; o cupom por trás pode ser o mesmo pra todos. Um código com outro nome chega e é ignorado.
Teste antes de valer
Cada ligação pode ficar em modo de teste: os avisos do Stripe entram num registro que você vê no painel, sem contar no mês. Quando a primeira venda de teste aparecer certinha, é só virar pra produção. A documentação do Stripe sobre webhooks está aqui.
Perguntas
- O dinheiro da venda passa pelo criador.studio?
- Não. A venda cai na plataforma como sempre. O criador.studio só registra a venda com cupom, calcula a comissão e monta a lista do Pix, que sai da sua conta.
- Precisa de um cupom por criador no Stripe?
- Precisa de um código promocional por criador. O cupom por trás pode ser o mesmo pra todos (10% de desconto, por exemplo); o que muda é o código que o cliente digita.
- Por que vocês pedem uma chave restrita?
- Porque o aviso do Stripe só traz o id do código promocional, não o código. A chave, só com leitura de Sessões do Checkout, Faturas e Códigos promocionais, serve pra ler qual código foi usado. Ela não mexe em nada.
- E renovação de assinatura?
- Cada fatura paga chega como uma cobrança da assinatura, e a regra da marca decide se a comissão vale em toda renovação.