Listar facturas Stripe del usuario autenticado

GET 
/billing/invoices

Propósito

Devolver facturas Stripe simplificadas del usuario autenticado con soporte de paginación por cursor.

Objetivo

Permitir construir histórico de facturación en frontend sin exponer toda la estructura nativa de Stripe.

Casos de uso

• Renderizar listado de facturas en panel de billing.
• Cargar más resultados con cursor (starting_after).
• Acceder a URL PDF y hosted invoice para descarga/visualización.

Detalles técnicos

limit se parsea como entero y por defecto toma 10. starting_after se usa como cursor Stripe. La respuesta devuelve data[] de facturas normalizadas, hasMore y lastId. En catch, usa returnKO sin código explícito (418).

Autenticación

Requiere JWT Bearer token o API key (isLoged middleware).

Request

Responses

200

Facturas obtenidas correctamente

401

Token/API key ausente, inválido o cuenta bloqueada

404

Usuario o compañía no encontrada para el contexto autenticado

418

Error funcional al listar facturas