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
- 401
- 404
- 418
Facturas obtenidas correctamente
Token/API key ausente, inválido o cuenta bloqueada
Usuario o compañía no encontrada para el contexto autenticado
Error funcional al listar facturas