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.completedinvoice.payment_succeededcharge.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
identifycom 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".