Umsatzzuordnung mit der Stripe PaymentIntent API
Stellen Sie zunächst sicher, dass Sie Ihr Stripe-Konto verknüpft haben.
Verwenden Sie diese Anleitung für benutzerdefinierte Stripe-Checkouts — das Payment Element, confirmCardPayment oder jeden Ablauf, bei dem Sie den PaymentIntent selbst erstellen. Diese erzeugen keine Stripe Checkout Session, sodass es keine client_reference_id gibt, die das Skript befüllen könnte (das funktioniert nur bei Payment Links). Sie müssen das Besucher-Cookie selbst in die PaymentIntent-metadata weitergeben — das ist das einzige deterministische Signal für diesen Ablauf.
Flowsery verarbeitet diese Stripe-Webhook-Events:
payment_intent.succeeded— wird von benutzerdefinierten PaymentIntent-Checkouts ausgelöstcheckout.session.completedinvoice.payment_succeededcharge.refunded
Das Routing zur richtigen Website erfolgt automatisch (Flowsery registriert pro Website eine eigene Webhook-URL) — Sie müssen websiteId nicht übergeben. Um die Zahlung der Traffic-Quelle des Besuchers zuzuordnen, geben Sie die Flowsery-Cookies (_fs_vid / _fs_sid) als metadata weiter, wenn Sie den PaymentIntent erstellen:
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 liest fs_visitor_id aus dem payment_intent.succeeded-Webhook und verknüpft die Zahlung mit der Journey dieses Besuchers (Referrer, Kanal, Land, Gerät). Ohne diese Angabe wird die Zahlung zwar als Umsatz erfasst, aber mit einer „Unbekannt"-Quelle.
Fallback, wenn Sie keine metadata setzen können: Rufen Sie identify mit der E-Mail des Käufers auf (window.flowsery('identify', { userId: user.id, email: user.email })). Flowsery ordnet die Zahlung dann anhand der E-Mail-Adresse dem Besucher zu.