Atrybucja przychodów
Atrybucja przychodów ze Stripe Checkout API
Zanim przejdziesz dalej, upewnij się, że masz połączone konto Stripe.
Nie musisz już przekazywać websiteId: Flowsery rejestruje osobny adres URL webhooka dla każdej witryny, więc płatności automatycznie trafiają do właściwej strony.
Aby przypisać płatność do źródła ruchu odwiedzającego, przekaż pliki cookie Flowsery (_fs_vid i _fs_sid) do metadata Checkout Session podczas tworzenia sesji po stronie serwera:
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 odczytuje fs_visitor_id z webhooka i łączy płatność ze ścieżką tego odwiedzającego (źródło odesłania, kanał, kraj, urządzenie).
Obsługiwane zdarzenia webhooka Stripe
checkout.session.completedinvoice.payment_succeededcharge.refunded
Brak metadanych? Flowsery i tak przypisze płatność, jeśli to możliwe
- Stripe Payment Links przypisują przychód automatycznie: skrypt Flowsery dodaje identyfikator odwiedzającego jako
client_reference_id. Zobacz Payment Links. - Niestandardowe płatności z Payment Element / PaymentIntent nie mają Checkout Session, więc przekaż plik cookie do metadanych PaymentIntent. Zobacz PaymentIntent API.
- Jeśli wywołasz
identifyz adresem e-mail kupującego, Flowsery dopasuje płatność do odwiedzającego po tym adresie. - W pozostałych przypadkach płatność i tak zostanie zapisana jako przychód, ze źródłem „Nieznany”.