Reportar uso (metered)
POST/v1/usage
Reporta uso para facturación metered. Acepta un registro único o un lote { records: [...] } con hasta 100 ítems. Cada registro debe identificar el ítem de suscripción por subscription_item_id o por product_slug + customer_id (recomendado para integraciones externas). El precio/producto debe estar configurado con usage_type=metered y la suscripción debe estar active o trialing. Usa idempotency_key para evitar duplicados — cuando la clave ya fue vista, la respuesta marca duplicate: true. Los lotes con fallas parciales devuelven 207 Multi-Status.
Request
Responses
- 200
- 207
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Resultado del procesamiento (registro único o lote).
Resultado del procesamiento (registro único o lote).
El cuerpo de la solicitud falló en la validación.
Token bearer ausente o inválido.
Token válido, pero sin permiso para esta operación.
Recurso no encontrado en la organización actual.
El cuerpo de la solicitud falló en la validación.
Límite de solicitudes excedido.
Error inesperado en el servidor.