Pomoc/Atrybucja przychodów
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.completed
  • invoice.payment_succeeded
  • charge.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 identify z 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”.