Attribuer les revenus avec la Stripe Checkout API

Avant de continuer, confirmez que vous avez connecté votre compte Stripe.

Vous n'avez plus besoin de transmettre websiteId — Flowsery enregistre une URL de webhook dédiée par site web, de sorte que les paiements sont automatiquement acheminés vers le bon site.

Pour attribuer un paiement à la source de trafic du visiteur, transmettez les cookies Flowsery (_fs_vid et _fs_sid) dans la metadata de la Checkout Session lorsque vous créez la session côté serveur :

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,
  },
});

Flowsery lit fs_visitor_id depuis le webhook et relie le paiement au parcours de ce visiteur (référent, canal, pays, appareil).

Événements de webhook Stripe pris en charge

checkout.session.completed
invoice.payment_succeeded
charge.refunded

Pas de metadata ? Flowsery attribue tout de même quand c'est possible

Les Stripe Payment Links sont attribués automatiquement — le script Flowsery ajoute l'identifiant du visiteur en tant que client_reference_id. Voir Payment Links.
Si vous appelez identify(email), Flowsery associe le paiement au visiteur par e-mail.
Sinon, le paiement est tout de même enregistré comme revenu, avec une source « Inconnue ».