Usage Record Object

Um subscription_item_usage_record registra uma quantidade usada por um item metered. No fechamento do período, a Chargefy agrega os registros conforme aggregate_usage do item e cria a linha de invoice correspondente.

{
  "id": "ur_123",
  "object": "subscription_item_usage_record",
  "action": "increment",
  "created_at": "2026-05-20T12:00:00Z",
  "livemode": true,
  "metadata": {},
  "period_end": "2026-06-19T18:00:00Z",
  "period_start": "2026-05-19T18:00:00Z",
  "quantity": 42,
  "subscription": "sub_123",
  "subscription_item": "si_123",
  "timestamp": "2026-05-20T12:00:00Z",
  "updated_at": null
}

string

ID do registro (ur_*).

object

string

Sempre "subscription_item_usage_record".

action

string

increment soma a quantidade ao acumulado; set substitui o acumulado no ponto do registro.

quantity

integer

Quantidade registrada.

subscription_item

string

Item medido (si_*) que recebeu o uso.

timestamp

string

Momento do uso em ISO 8601.