Elija sus eventos de Stripe
Empiece con los cuatro eventos que cubren pagos, fallos y cancelaciones. Puede añadir más adelante.
- checkout.session.completed – un cliente completa el pago de una compra única o de una nueva suscripción.
- invoice.payment_succeeded – se paga una factura recurrente, incluidas las renovaciones de suscripción.
- invoice.payment_failed – un cobro o una renovación falla, a menudo la primera señal de un problema con la tarjeta.
- customer.subscription.deleted – una suscripción termina, ya sea cancelada de inmediato o al final del periodo.
Dentro de su gestor de webhooks de Stripe, reenvíe los campos que importan.
Verifique primero la firma de Stripe, luego envíe una llamada HTTP a LogsNinja con el importe como metadato: alimenta tanto la alerta como el gráfico de ingresos.
$ curl -X POST https://api.logsninja.com/v1/events \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -d '{ "project": "YOUR_PROJECT_ID", "stream": "payments", "title": "New subscription", "content": "[email protected] subscribed to Pro", "emoji": "💳", "metadata": {"plan": "pro", "amount": 49}, "notify": true }' ✓ Event received ✓ Push sent to 2 devices # revenue chart updated
Despliéguelo con seguridad
Verifique antes de confiar
- Compruebe el encabezado Stripe-Signature con el secreto de firma de su webhook antes de procesar nada.
- Mantenga su clave secreta de Stripe y su token de API de LogsNinja fuera del código del lado del cliente.
- Nunca reenvíe números de tarjeta completos ni CVC: Stripe tampoco los envía a su webhook.
Gestione los reintentos
- Stripe reintenta los webhooks no entregados: devuelva un 200 rápidamente y procese de forma asíncrona si es necesario.
- Use el ID de evento de Stripe como clave de idempotencia para que un webhook reintentado no cree una alerta duplicada.
- Registre los fallos de entrega en su lado; los eventos de LogsNinja enviados más tarde igualmente llegan al gráfico correcto.
Construya estos gráficos en su panel
Cada widget usa los mismos eventos que acabas de empezar a enviar, sin una segunda integración. Los ingresos de hoy suman el metadato amount del flujo payments; los demás cuentan eventos por título.
Valores de ejemplo mostrados a modo ilustrativo.
Preguntas frecuentes
¿Necesito cambiar mi integración de Stripe?
No. Mantenga su endpoint de webhook de Stripe actual. Añada una llamada HTTP a LogsNinja dentro de su gestor existente, después de verificar la firma.
¿Qué eventos de Stripe debo añadir más adelante?
customer.subscription.created para nuevas pruebas, charge.refunded para reembolsos, e invoice.payment_action_required si admite 3D Secure.
¿Es seguro enviar el importe del pago a LogsNinja?
Sí. El importe se guarda como metadato del evento, el mismo campo que alimenta su gráfico de ingresos. Nunca envíe números de tarjeta completos ni CVC: Stripe ni siquiera se los envía a su webhook.