Registrar uso

Registra unidades de uso de um produto avulso (pay-as-you-go) em uma assinatura ativa.

O registro é vinculado à próxima parcela pendente da assinatura e incluído na cobrança do ciclo atual. Use action: "add" para acrescentar unidades e action: "subtract" para estornar unidades já registradas.

O produto informado em productId não deve ter ciclo de cobrança. Produtos de assinatura (com ciclo) retornam erro.

{
  "id": "subs_abc123xyz",
  "productId": "prod_api_calls",
  "units": 50,
  "action": "add"
}

{
  "data": {
    "id": "usgr_abc123xyz",
    "subscriptionId": "subs_abc123xyz",
    "productId": "prod_api_calls",
    "units": 50,
    "unitPrice": 100,
    "action": "add",
    "installmentNumber": 2,
    "recordedAt": "2024-12-06T20:10:00.000Z"
  },
  "success": true
}