Omzet toeschrijven met de Stripe PaymentIntent API
Controleer voordat je verdergaat of je je Stripe-account hebt gekoppeld.
Gebruik deze handleiding voor eigen Stripe-checkouts: het Payment Element, confirmCardPayment of elke flow waarin je de PaymentIntent zelf aanmaakt. Die leveren nooit een Stripe Checkout Session op, dus is er geen client_reference_id die het script kan invullen (dat werkt alleen bij Payment Links). Je moet de bezoekerscookie zelf doorgeven aan de metadata van de PaymentIntent: voor deze flow is dat het enige deterministische signaal.
Flowsery verwerkt deze Stripe-webhookevents:
payment_intent.succeeded: verstuurd door eigen PaymentIntent-checkoutscheckout.session.completedinvoice.payment_succeededcharge.refunded
De routering naar de juiste website gaat automatisch (Flowsery registreert per site een eigen webhook-URL): je hoeft websiteId niet mee te geven. Wil je de betaling toeschrijven aan de verkeersbron van de bezoeker, geef de cookies van Flowsery (_fs_vid / _fs_sid) dan als metadata mee wanneer je de PaymentIntent aanmaakt:
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'],
},
});Flowsery leest fs_visitor_id uit de webhook payment_intent.succeeded en koppelt de betaling aan de journey van die bezoeker (verwijzer, kanaal, land, apparaat). Zonder deze waarde wordt de betaling nog steeds als omzet vastgelegd, maar met de bron "Onbekend".
Alternatief als je geen metadata kunt meegeven: roep identify aan met het e-mailadres van de koper (window.flowsery('identify', { userId: user.id, email: user.email })). Flowsery koppelt de betaling dan via het e-mailadres aan de bezoeker.