Recibir eventos de webhook Stripe de billing ECMR
POST/billing/webhook/stripe
Propósito
Recibir y validar eventos enviados por Stripe para mantener sincronizado el estado de suscripciones y facturas en ECMR.
Objetivo
Procesar eventos como checkout.session.completed,
customer.subscription.updated o eventos de invoice para actualizar
ciclos de facturación y estado interno del usuario.
Casos de uso
- Confirmar una suscripción completada tras checkout.
- Sincronizar cambios de estado de suscripción.
- Registrar pagos o fallos de pago de facturas.
Detalles técnicos
Requiere cabecera stripe-signature para verificar firma con
STRIPE_WEBHOOK_SECRET.
El endpoint usa req.rawBody (o fallback req.body) para construir
el evento con Stripe y no usa returnOK/returnKO; responde JSON simple
en éxito y text/plain en errores de firma/handler.
Autenticación
No requiere JWT ni API key. La autenticación es criptográfica por
firma Stripe (stripe-signature).
Request
Responses
- 200
- 400
- 500
Evento aceptado y procesado
Firma inválida o payload no verificable
Error interno al procesar el evento validado