Atribuir receita com a Stripe PaymentIntent API
Antes de prosseguir, confirme que você vinculou sua conta Stripe.
Use este guia para checkouts personalizados da Stripe: o Payment Element, o confirmCardPayment ou qualquer fluxo em que você mesmo cria o PaymentIntent. Esses fluxos nunca geram uma Checkout Session da Stripe, então não existe nenhum client_reference_id que o script possa preencher (isso só funciona com os Payment Links). Você precisa encaminhar o cookie do visitante para a metadata do PaymentIntent: é o único sinal determinístico para este fluxo.
O Flowsery processa estes eventos de webhook da Stripe:
payment_intent.succeeded: emitido pelos checkouts personalizados com PaymentIntentcheckout.session.completedinvoice.payment_succeededcharge.refunded
O encaminhamento para o website correto é automático (o Flowsery registra uma URL de webhook dedicada por site): você não precisa passar o websiteId. Para atribuir o pagamento à fonte de tráfego do visitante, encaminhe os cookies do Flowsery (_fs_vid / _fs_sid) como metadata ao criar o PaymentIntent:
const paymentIntent = await stripe.paymentIntents.create({
amount: 2000,
currency: 'usd',
metadata: {
fs_visitor_id: req.cookies['_fs_vid'],
fs_session_id: req.cookies['_fs_sid'],
},
});O Flowsery lê o fs_visitor_id do webhook payment_intent.succeeded e associa o pagamento à jornada desse visitante (referenciador, canal, país, dispositivo). Sem ele, o pagamento é registrado como receita mesmo assim, mas com a origem "Desconhecida".
Alternativa se você não conseguir definir metadata: chame identify com o e-mail do comprador (window.flowsery('identify', { userId: user.id, email: user.email })). Assim, o Flowsery associa o pagamento ao visitante pelo e-mail.