Soporte/Atribución de ingresos
Atribución de ingresos

Atribuir ingresos con la Stripe Checkout API

Antes de continuar, confirma que has vinculado tu cuenta de Stripe.

Ya no necesitas pasar websiteId — Flowsery registra una URL de webhook dedicada por sitio web, por lo que los pagos se enrutan automáticamente al sitio correcto.

Para atribuir un pago a la fuente de tráfico del visitante, reenvía las cookies de Flowsery (_fs_vid y _fs_sid) a la metadata de la Checkout Session cuando crees la sesión en el servidor:

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 lee fs_visitor_id desde el webhook y vincula el pago al recorrido de ese visitante (referente, canal, país, dispositivo).

Eventos de webhook de Stripe compatibles

  • checkout.session.completed
  • invoice.payment_succeeded
  • charge.refunded

¿Sin metadata? Flowsery sigue atribuyendo cuando puede

  • Los Stripe Payment Links se atribuyen automáticamente — el script de Flowsery agrega el id del visitante como client_reference_id. Consulta Payment Links.
  • Si llamas a identify(email), Flowsery asocia el pago al visitante por correo electrónico.
  • De lo contrario, el pago se registra igualmente como ingreso, con una fuente «Desconocida».