Integração com o Stripe

Com o Stripe conectado, faturas pagas de clientes indicados viram conversões; estornos, disputas e cancelamentos ajustam as comissões. O Pix aos afiliados continua saindo da sua conta Asaas (ou pela exportação).

Criar a chave restrita

Use uma chave restrita em modo de teste (rk_test_…) com apenas as permissões necessárias. No Stripe: Desenvolvedores → Chaves de API → Criar chave restrita.

Recurso	Permissão	Para quê
Customers	Leitura	Reconhecer o cliente indicado
Invoices, Charges	Leitura	Valores e estornos
Checkout Sessions	Leitura	Código de indicação no checkout
Webhook Endpoints	Escrita	Registrar o webhook sozinhos
Subscriptions	Escrita	Aplicar desconto de recompensa na assinatura de quem indicou
Coupons, Promotion Codes	Escrita	Criar o cupom do amigo e o desconto de recompensa

Espaço reservado: capturas de tela da criação da chave restrita no painel do Stripe.

Conectar

Em Integrações → Stripe → Conectar, cole a chave. Registramos um webhook fixado na versão 2024-06-20 da API do Stripe com os eventos invoice.paid, checkout.session.completed, charge.refunded, charge.dispute.created e customer.subscription.deleted, e guardamos o segredo de assinatura criptografado.

Passar o código de indicação

O jeito mais simples é o snippet (Instalar o snippet) e Filiafy.convert() no cadastro. Se você cria o Checkout, também pode enviar o código:

const session = await stripe.checkout.sessions.create({
  // …
  client_reference_id: window.Filiafy?.referral ?? undefined,
  metadata: { filiafy_ref: codigo },
})

Aceitamos client_reference_id e os metadados filiafy_ref, referral_code ou ref na sessão, na fatura ou na assinatura.