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