Atrybucja przychodów ze Stripe PaymentIntent API
Zanim przejdziesz dalej, upewnij się, że masz połączone konto Stripe.
Ten przewodnik dotyczy niestandardowych płatności Stripe: Payment Element, confirmCardPayment lub dowolnego procesu, w którym samodzielnie tworzysz PaymentIntent. Takie płatności nigdy nie tworzą Stripe Checkout Session, więc skrypt nie ma czego wpisać do client_reference_id (działa to tylko w przypadku Payment Links). Plik cookie odwiedzającego musisz samodzielnie przekazać do metadanych PaymentIntent: to jedyny jednoznaczny sygnał w tym procesie.
Flowsery przetwarza te zdarzenia webhooka Stripe:
payment_intent.succeeded: wysyłane przez niestandardowe płatności PaymentIntentcheckout.session.completedinvoice.payment_succeededcharge.refunded
Kierowanie do właściwej witryny odbywa się automatycznie (Flowsery rejestruje osobny adres URL webhooka dla każdej strony), więc nie musisz przekazywać websiteId. Aby przypisać płatność do źródła ruchu odwiedzającego, przekaż pliki cookie Flowsery (_fs_vid / _fs_sid) jako metadane podczas tworzenia PaymentIntent:
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 odczytuje fs_visitor_id z webhooka payment_intent.succeeded i łączy płatność ze ścieżką tego odwiedzającego (źródło odesłania, kanał, kraj, urządzenie). Bez tej wartości płatność i tak zostanie zapisana jako przychód, ale ze źródłem „Nieznany”.
Rozwiązanie awaryjne, gdy nie możesz ustawić metadanych: wywołaj identify z adresem e-mail kupującego (window.flowsery('identify', { userId: user.id, email: user.email })). Flowsery dopasuje wtedy płatność do odwiedzającego po tym adresie.