¿Cómo conecto Stripe?

Creas en Stripe un endpoint de webhook con la URL de ORION, marcas siete eventos y pegas en ORION el Signing secret (empieza por whsec_).

Actualizado el

Stripe se conecta con un webhook. Stripe avisa a ORION de cada cobro y ORION comprueba con tu Signing secret que el aviso viene de tu cuenta. Sirve para suscripciones, renovaciones y pagos únicos.

Pasos

  1. En ORION, entra a Integraciones y, en Pasarelas y links de pago, pulsa Configurar en Stripe. Se abre Conecta Stripe.
  2. Abre el Dashboard de Stripe en modo producción, no en modo prueba, y ve a la sección de Webhooks. El botón Abrir Webhooks en Stripe te lleva ahí.
  3. Crea un endpoint de webhook nuevo y pega la URL que ORION te muestra con Copiar URL.
  4. Selecciona exactamente estos siete eventos y guarda el endpoint: checkout.session.completed, invoice.paid, charge.refunded, charge.dispute.created, customer.subscription.created, customer.subscription.updated y customer.subscription.deleted. Los tres últimos sirven para las pruebas gratis: sin ellos, el primer cobro tras la prueba se contaría como renovación.
  5. En la página del endpoint, revela y copia el Signing secret (empieza por whsec_). Pégalo en ORION y pulsa Conectar Stripe.
  6. En Comprobar que llega, envía desde Stripe un evento de prueba invoice.paid. En unos segundos verás Stripe ya habla con ORION. Los eventos de prueba no se guardan como ventas.

Después de conectar

  • Crea tus planes en Productos con el ID de producto de Stripe (prod_…) para que cada cobro caiga en su plan.
  • Para saber qué anuncio trajo cada cobro, tu web tiene que pasar el código de ORION al crear la sesión de Checkout: metadata.xcod o client_reference_id en pagos únicos, y subscription_data.metadata.xcod en suscripciones, para que cada renovación lleve su anuncio. Si no lo hace, la venta suma igual a tus ingresos, pero sin anuncio. Paso a paso en la guía Stripe + Meta Ads.
  • Con Payment Links (buy.stripe.com) no hace falta programar: ORION usa client_reference_id para el ID del anuncio. Pega orion.js en tu web, o, si el anuncio lleva directo al enlace, añade &client_reference_id={{ad.id}} a sus parámetros de URL. En suscripciones, cada renovación cuenta para ese anuncio.

Ventas pasadas: Stripe permite traer tus cobros de los últimos 3 meses con una clave restringida de solo lectura. Mira «¿Puedo traer mis ventas anteriores a la conexión?».

Si no funciona

  • Creaste el endpoint en modo prueba: las ventas reales van por el modo producción. Repite los pasos allí.
  • Falta algún evento: sin invoice.paid no llegan las renovaciones; sin checkout.session.completed, los pagos únicos.
  • Copiaste mal el secreto: abre la tarjeta de Stripe y pulsa Actualizar Signing secret.

¿No te lo resuelve?

Pregúntale al robot de abajo a la derecha con tus palabras: responde al momento y, si hace falta, te dice cómo escribirnos.

Usamos cookies de Google Analytics y del píxel de Meta para medir las visitas y nuestros anuncios. Puedes rechazarlas y no volverán a activarse. Más información