Saltar al contenido principal

Procesar webhook de pagos (Stripe)

POST 
/webhooks/payment

Recibe y procesa webhooks de Stripe relacionados con pagos y métodos de pago.

Eventos soportados:

  • charge.succeeded: Registra facturas pagadas para empresas
  • setup_intent.succeeded: Configura método de pago por defecto
  • payment_intent.succeeded: Marca ECMRs como pagados

Validación de seguridad:

  • Verifica firma digital usando STRIPE_WEBHOOK_SECRET
  • Rechaza webhooks con firma inválida
  • Solo procesa eventos de clientes registrados en el sistema

Comportamiento:

  • Eventos no soportados se registran pero no se procesan
  • Procesamiento idempotente (maneja duplicados)
  • Actualiza estados de pago en tiempo real

Notas importantes:

  • Este endpoint no requiere autenticación JWT
  • Debe ser configurado como endpoint público en Stripe Dashboard
  • Responde rápidamente para evitar timeouts de Stripe

Request​

Responses​

Operación realizada correctamente