orb-billing 1.40.0 → 1.42.0

data/rbi/orb/resources/events/backfills.rbi

@@ -48,7 +48,9 @@ module Orb
         # the event reporting grace boundary. Matching events that arrive later with
         # timestamps inside the timeframe will also be deprecated.
         #
-        # You may not have multiple backfills in a pending or pending_revert state with
+        # A backfill may not overlap in timeframe with another backfill in a pending or
+        # pending_revert state for the same customer, or with any account-wide backfill in
+        # one of those states. Backfills scoped to different customers may have
         # overlapping timeframes.
         sig do
           params(

data/rbi/orb/resources/invoices.rbi

@@ -412,14 +412,14 @@ module Orb
       sig do
         params(
           invoice_id: String,
-          shared_payment_token_id: String,
+          shared_payment_token_id: T.nilable(String),
           request_options: Orb::RequestOptions::OrHash
         ).returns(Orb::Invoice)
       end
       def pay(
         invoice_id,
         # The ID of a shared payment token granted by an agent to use for this payment.
-        shared_payment_token_id:,
+        shared_payment_token_id: nil,
         request_options: {}
       )
       end

data/rbi/orb/resources/subscriptions.rbi

@@ -745,9 +745,9 @@ module Orb
       # but do not have the key set). Currently, it is only possible to view usage
       # grouped by a single attribute at a time.
       #
-      # When viewing grouped usage, Orb uses pagination to limit the response size to
-      # 1000 groups by default. If there are more groups for a given subscription,
-      # pagination metadata in the response can be used to fetch all of the data.
+      # When viewing grouped usage, all groups are returned in a single response. For
+      # metrics with a large number of groups, Orb recommends using a shorter timeframe
+      # to keep response size and latency manageable.
       #
       # The following example shows usage for an "API Requests" billable metric grouped
       # by `region`. Note the extra `metric_group` dictionary in the response, which