Skip to main content

RecordUsage logs a billable usage event.

POST 
/billing.v1.UsageService/RecordUsage

Called by internal services when metered events occur. Not exposed via HTTP - gRPC only for service-to-service calls.

Authorization​

Internal service authentication required.

Idempotency​

Provide idempotency_key for at-least-once delivery semantics. Duplicate keys within 24 hours are deduplicated.

Wallet Deduction​

For prepaid accounts, amount is immediately deducted from wallet. Low balance triggers wallet alerts.

Errors​

  • INVALID_ARGUMENT: Invalid metric or quantity
  • FAILED_PRECONDITION: Insufficient wallet balance (prepaid)
  • ALREADY_EXISTS: Duplicate idempotency_key (returns success)

Request​

Responses​

A successful response.