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

Atribuir receita com a Stripe Checkout API

Antes de prosseguir, confirme que vinculou a sua conta Stripe.

Já não precisa de passar o websiteId — o Flowsery regista um URL de webhook dedicado por website, pelo que 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 na mesma quando possível

  • Os Stripe Payment Links são atribuídos automaticamente — o script do Flowsery acrescenta o id do visitante como client_reference_id. Consulte Payment Links.
  • Se chamar identify(email), o Flowsery associa o pagamento ao visitante por e-mail.
  • Caso contrário, o pagamento é na mesma registado como receita, com uma fonte "Desconhecida".