ccriador.studio
Integração · Stripe

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 em

O 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

  1. 1No criador.studio, abra Integração › Onde você vende? › Stripe. O painel mostra o endereço da sua marca:criador.studio/api/hooks/stripe/••••••••
  2. 2No Stripe, abra Desenvolvedores › Webhooks (Workbench) e clique em Adicionar destino.
  3. 3Escolha Sua conta e marque estes eventos:checkout.session.completedcheckout.session.async_payment_succeededinvoice.paidcharge.refunded
  4. 4Escolha Endpoint de webhook e cole o endereço acima no campo URL.
  5. 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.
Ligue o Stripe e chame o primeiro criador.14 dias grátis, sem cartão. O dinheiro continua indo direto pra você.Testar 14 dias grátis