Suporte/Atribuição de receita
Atribuição de receita

Atribuir receita com a Stripe Checkout API

Antes de prosseguir, confirme que você vinculou sua conta Stripe.

Você não precisa mais passar o websiteId: o Flowsery registra uma URL de webhook dedicada por website, então os pagamentos são encaminhados automaticamente para o site correto.

Para atribuir um pagamento à fonte de tráfego do visitante, encaminhe os cookies do Flowsery (_fs_vid e _fs_sid) para a metadata da Checkout Session quando criar a sessão no servidor:

JavaScript
import { cookies } from 'next/headers';
 
const cookieStore = await cookies();
 
const session = await stripe.checkout.sessions.create({
  line_items: [...],
  mode: 'payment',
  metadata: {
    fs_visitor_id: cookieStore.get('_fs_vid')?.value,
    fs_session_id: cookieStore.get('_fs_sid')?.value,
  },
});

O Flowsery lê o fs_visitor_id a partir do webhook e associa o pagamento à jornada desse visitante (referrer, canal, país, dispositivo).

Eventos de webhook Stripe suportados

  • checkout.session.completed
  • invoice.payment_succeeded
  • charge.refunded

Sem metadata? O Flowsery atribui mesmo assim quando possível

  • Os Stripe Payment Links são atribuídos automaticamente: o script do Flowsery adiciona o id do visitante como client_reference_id. Consulte Payment Links.
  • Os checkouts personalizados com Payment Element / PaymentIntent não têm Checkout Session, por isso encaminhe o cookie para a metadata do PaymentIntent. Consulte PaymentIntent API.
  • Se você chamar identify com o e-mail do comprador, o Flowsery associa o pagamento ao visitante por e-mail.
  • Caso contrário, o pagamento é registrado como receita mesmo assim, com uma fonte "Desconhecida".