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. Con code insufficient_scope, details.required trae el único conjunto mínimo de scopes que, sumados a details.granted, dejaría pasar la solicitud: el scope del recurso (billing/{recurso}, o billing/all fuera del catálogo) y luego el verbo simple — por ejemplo ["billing/customers", "delete"].
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.