Confirma conversiones desde Stripe

Qué hace

Cuando alguien paga con Stripe, es Stripe quien avisa a TraceLog. Ese aviso no depende de la página ni de Google Tag Manager, así que llega aunque fallen.

Cuentan los pagos únicos, el primer pago de una suscripción y los pagos diferidos que se completan. Los reembolsos, las renovaciones y los pagos de prueba, no.

De cada aviso, TraceLog guarda el identificador y la hora: ningún nombre, correo ni importe.

Configúralo

Abre Instalación y claves en tu proyecto, elige Configurar en Confirma conversiones desde Stripe y, después:

1. En Stripe, abre Webhooks en Workbench y elige Crear un destino de evento y, después, Tu cuenta.
2. En el formato de la carga útil, elige Resumen. Stripe recomienda Ligero, pero Ligero no trae nada que TraceLog pueda confirmar. Deja la versión de la API como está.
3. Selecciona checkout.session.completed, checkout.session.async_payment_succeeded y payment_intent.succeeded.
4. Elige Punto de conexión de webhook y pega la dirección que te da TraceLog como URL del punto de conexión.
5. Elige Revelar secreto y pega el secreto de firma en TraceLog.

Si Stripe está en español de Latinoamérica, Resumen aparece como Instantánea y Ligero como Breve.

La dirección tiene esta forma: https://api.tracelog.io/v1/platforms/stripe/webhooks/:endpointId.

Envía el identificador

Cada pago tiene que llevar el identificador que envía tu página, como el número de pedido.

Con Checkout:

await stripe.checkout.sessions.create({
  mode: "payment",
  client_reference_id: order.number,
  // productos y direcciones
});

Con un Payment Link:

https://buy.stripe.com/tu-enlace?client_reference_id=pedido-1042

Con un formulario propio:

await stripe.paymentIntents.create({
  amount: order.total,
  currency: order.currency,
  metadata: { tracelog_identifier: order.number },
});

Para una suscripción con Checkout, en la sesión, igual que en un pago único:

await stripe.checkout.sessions.create({
  mode: "subscription",
  client_reference_id: order.number,
  // productos y direcciones
});

Para una suscripción con formulario propio, ponlo en el PaymentIntent del primer pago:

await stripe.paymentIntents.update(firstPaymentIntentId, {
  metadata: { tracelog_identifier: order.number },
});

Usa el identificador que tu página envía con la conversión, uno por pedido, nunca el correo de una persona. Un identificador en blanco, de más de 256 caracteres o con @ no confirma nada.

Qué verás

El recuento de la conversión dice quién la vio: solo el servidor, o el navegador y el servidor cuando la página envió el mismo identificador.

La sección de Instalación y claves muestra un solo estado:

• El secreto no coincide. Los avisos de Stripe no coinciden con el secreto de firma. Vuelve a copiar el secreto del destino.
• Formato equivocado. El destino envía Ligero. Crea uno en Resumen.
• Modo de prueba. Los avisos vienen de un entorno o modo de prueba. Crea un destino en modo activo.
• La conversión ya no está. No figura en tu recorrido de conversión. Elige Quitar y vuelve a configurar Stripe con la conversión nueva.
• Último pago confirmado, con su fecha.
• Llegan avisos. Llegan, pero ninguno ha confirmado una conversión.
• Aún no hay avisos. El primero llegará con el próximo pago.

TraceLog no guarda ningún importe de Stripe, así que el valor de una conversión es el que envía tu página.

Si cobras de otras formas

Solo se confirman los pagos con Stripe; del resto, TraceLog solo tiene lo que vio el navegador. Stripe confirma una conversión por proyecto.