Reportar uso (metered)
POST/v1/usage
Reporta uso para faturamento metered. Aceita um registro único ou um lote { records: [...] } com até 100 itens. Cada registro precisa identificar o item de assinatura por subscription_item_id ou por product_slug + customer_id (recomendado para integrações externas). O preço/produto deve estar configurado como usage_type=metered e a assinatura precisa estar active ou trialing. Use idempotency_key para evitar duplicidade — em caso de chave já vista, a resposta marca duplicate: true. Lotes com falhas parciais retornam 207 Multi-Status.
Request
Responses
- 200
- 207
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Resultado do processamento (registro único ou lote).
Resultado do processamento (registro único ou lote).
Corpo da requisição falhou na validação.
Token bearer ausente ou inválido.
Token válido, porém sem permissão para esta operação.
Recurso não encontrado na organização atual.
Corpo da requisição falhou na validação.
Limite de requisições excedido.
Erro inesperado no servidor.