metronome-sdk 1.0.0 → 2.0.0

data/lib/metronome_sdk/resources/v1/customers/alerts.rb

@@ -8,17 +8,26 @@ module MetronomeSDK
           # Some parameter documentations has been truncated, see
           # {MetronomeSDK::Models::V1::Customers::AlertRetrieveParams} for more details.
           #
-          # Retrieve the real-time evaluation status for a specific alert-customer pair.
-          # This endpoint provides instant visibility into whether a customer has triggered
-          # an alert condition, enabling you to monitor account health and take proactive
-          # action based on current alert states.
+          # Retrieve the real-time evaluation status for a specific threshold
+          # notification-customer pair. This endpoint provides instant visibility into
+          # whether a customer has triggered a threshold notification condition, enabling
+          # you to monitor account health and take proactive action based on current
+          # threshold notification states.
           #
           # ### Use this endpoint to:
           #
-          # - Check if a specific customer is currently violating an alert threshold
+          # - Check if a specific customer is currently violating an threshold notification
           #   (`in_alarm` status)
-          # - Verify alert configuration details and threshold values for a customer
-          # - Integrate alert status checks into customer support tools or admin interfaces
+          # - Verify threshold notification configuration details and threshold values for a
+          #   customer
+          # - Monitor the evaluation state of newly created or recently modified threshold
+          #   notification
+          # - Build dashboards or automated workflows that respond to specific threshold
+          #   notification conditions
+          # - Validate threshold notification behavior before deploying to production
+          #   customers
+          # - Integrate threshold notification status checks into customer support tools or
+          #   admin interfaces
           #
           # ### Key response fields:
           #
@@ -27,40 +36,43 @@ module MetronomeSDK
           # - `customer_status`: The current evaluation state
           #
           # - `ok` - Customer is within acceptable thresholds
-          # - `in_alarm`- Customer has breached the alert threshold
-          # - `evaluating` - Alert has yet to be evaluated (typically due to a customer or
-          #   alert having just been created)
-          # - `null` - Alert has been archived
-          # - `triggered_by`: Additional context about what caused the alert to trigger
-          #   (when applicable)
-          # - alert: Complete alert configuration including:
-          #   - Alert ID, name, and type
+          # - `in_alarm` - Customer has breached the threshold for the notification
+          # - `evaluating` - Notification is currently being evaluated (typically during
+          #   initial setup)
+          # - `null` - Notification has been archived
+          # - `triggered_by`: Additional context about what caused the notification to
+          #   trigger (when applicable)
+          # - alert: Complete threshold notification configuration including:
+          #   - Notification ID, name, and type
           #   - Current threshold values and credit type information
-          #   - Alert status (enabled, disabled, or archived)
+          #   - Notification status (enabled, disabled, or archived)
           #   - Last update timestamp
           #   - Any applied filters (credit grant types, custom fields, group values)
           #
           # ### Usage guidelines:
           #
           # - Customer status: Returns the current evaluation state, not historical data.
-          #   For alert history, use webhook notifications or event logs
-          # - Archived alerts: Returns null for customer_status if the alert has been
-          #   archived, but still includes the alert configuration details
-          # - Integration patterns: This endpoint can be used to check a customer's alert
-          #   status, but shouldn't be scraped. You should instead rely on the webhook
-          #   notification to understand when customers are moved to IN_ALARM.
-          # - Error handling: Returns 404 if either the customer or alert ID doesn't exist
+          #   For threshold notification history, use webhook notifications or event logs
+          # - Required parameters: Both customer_id and alert_id must be valid UUIDs that
+          #   exist in your organization
+          # - Archived notifications: Returns null for customer_status if the notification
+          #   has been archived, but still includes the notification configuration details
+          # - Performance considerations: This endpoint queries live evaluation state,
+          #   making it ideal for real-time monitoring but not for bulk status checks
+          # - Integration patterns: Best used for on-demand status checks in response to
+          #   user actions or as part of targeted monitoring workflows
+          # - Error handling: Returns 404 if either the customer or alert_id doesn't exist
           #   or isn't accessible to your organization
           #
           # @overload retrieve(alert_id:, customer_id:, group_values: nil, plans_or_contracts: nil, request_options: {})
           #
-          # @param alert_id [String] The Metronome ID of the alert
+          # @param alert_id [String] The Metronome ID of the threshold notification
           #
           # @param customer_id [String] The Metronome ID of the customer
           #
-          # @param group_values [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::GroupValue>] Only present for `spend_threshold_reached` alerts. Retrieve the alert for a spec
+          # @param group_values [Array<MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::GroupValue>] Only present for `spend_threshold_reached` notifications. Retrieve the notificat
           #
-          # @param plans_or_contracts [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::PlansOrContracts] When parallel alerts are enabled during migration, this flag denotes whether to
+          # @param plans_or_contracts [Symbol, MetronomeSDK::Models::V1::Customers::AlertRetrieveParams::PlansOrContracts] When parallel threshold notifications are enabled during migration, this flag de
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -81,31 +93,37 @@ module MetronomeSDK
           # Some parameter documentations has been truncated, see
           # {MetronomeSDK::Models::V1::Customers::AlertListParams} for more details.
           #
-          # Retrieve all alert configurations and their current statuses for a specific
-          # customer in a single API call. This endpoint provides a comprehensive view of
-          # all alerts monitoring a customer account.
+          # Retrieve all threshold notification configurations and their current statuses
+          # for a specific customer in a single API call. This endpoint provides a
+          # comprehensive view of all threshold notification monitoring a customer account.
           #
           # ### Use this endpoint to:
           #
-          # - Display all active alerts for a customer in dashboards or admin panels
-          # - Quickly identify which alerts a customer is currently triggering
-          # - Audit alert coverage for specific accounts
-          # - Filter alerts by status (enabled, disabled, or archived)
+          # - Display all active threshold notifications for a customer in dashboards or
+          #   admin panels
+          # - Quickly identify which threshold notifications a customer is currently
+          #   triggering
+          # - Audit threshold notification coverage for specific accounts
+          # - Filter threshold notifications by status (enabled, disabled, or archived)
           #
           # ### Key response fields:
           #
           # - data: Array of CustomerAlert objects, each containing:
           #   - Current evaluation status (`ok`, `in_alarm`, `evaluating`, or `null`)
-          #   - Complete alert configuration and threshold details
-          #   - Alert metadata including type, name, and last update time
-          # - `next_page`: Pagination cursor for retrieving additional results
+          #   - Complete threshold notification configuration and threshold details
+          #   - Threshold notification metadata including type, name, and last update time
+          # - next_page: Pagination cursor for retrieving additional results
           #
           # ### Usage guidelines:
           #
-          # - Default behavior: Returns only enabled alerts unless alert_statuses filter is
-          #   specified
+          # - Default behavior: Returns only enabled threshold notifications unless
+          #   `alert_statuses` filter is specified
           # - Pagination: Use the `next_page` cursor to retrieve all results for customers
-          #   with many alerts
+          #   with many notifications
+          # - Performance: Efficiently retrieves multiple threshold notification statuses in
+          #   a single request instead of making individual calls
+          # - Filtering: Pass the `alert_statuses` array to include disabled or archived
+          #   threshold notifications in results
           #
           # @overload list(customer_id:, next_page: nil, alert_statuses: nil, request_options: {})
           #
@@ -113,7 +131,7 @@ module MetronomeSDK
           #
           # @param next_page [String] Query param: Cursor that indicates where the next page of results should start.
           #
-          # @param alert_statuses [Array<Symbol, MetronomeSDK::Models::V1::Customers::AlertListParams::AlertStatus>] Body param: Optionally filter by alert status. If absent, only enabled alerts wi
+          # @param alert_statuses [Array<Symbol, MetronomeSDK::Models::V1::Customers::AlertListParams::AlertStatus>] Body param: Optionally filter by threshold notification status. If absent, only
           #
           # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -134,23 +152,24 @@ module MetronomeSDK
             )
           end
 
-          # Force an immediate re-evaluation of a specific alert for a customer, clearing
-          # any previous state and triggering a fresh assessment against current thresholds.
-          # This endpoint ensures alert accuracy after configuration changes or data
-          # corrections.
+          # Force an immediate re-evaluation of a specific threshold notification for a
+          # customer, clearing any previous state and triggering a fresh assessment against
+          # current thresholds. This endpoint ensures threshold notification accuracy after
+          # configuration changes or data corrections.
           #
           # ### Use this endpoint to:
           #
-          # - Clear false positive alerts after fixing data issues
-          # - Re-evaluate alerts after adjusting customer balances or credits
-          # - Test alert behavior during development and debugging
-          # - Resolve stuck alerts that may be in an incorrect state
+          # - Clear false positive threshold notifications after fixing data issues
+          # - Re-evaluate threshold notifications after adjusting customer balances or
+          #   credits
+          # - Test threshold notification behavior during development and debugging
+          # - Resolve stuck threshold notification that may be in an incorrect state
           # - Trigger immediate evaluation after threshold modifications
           #
           # ### Key response fields:
           #
-          # - 200 Success: Confirmation that the alert has been reset and re-evaluation
-          #   initiated
+          # - 200 Success: Confirmation that the threshold notification has been reset and
+          #   re-evaluation initiated
           # - No response body is returned - the operation completes asynchronously
           #
           # ### Usage guidelines:
@@ -165,7 +184,7 @@ module MetronomeSDK
           #
           # @overload reset(alert_id:, customer_id:, request_options: {})
           #
-          # @param alert_id [String] The Metronome ID of the alert
+          # @param alert_id [String] The Metronome ID of the threshold notification
           #
           # @param customer_id [String] The Metronome ID of the customer
           #

data/lib/metronome_sdk/resources/v1/customers/invoices.rb

@@ -299,6 +299,61 @@ module MetronomeSDK
             )
           end
 
+          # Retrieve a PDF version of a specific invoice by its unique identifier. This
+          # endpoint generates a professionally formatted invoice document suitable for
+          # sharing with customers, accounting teams, or for record-keeping purposes.
+          #
+          # ### Use this endpoint to:
+          #
+          # - Provide customers with downloadable or emailable copies of their invoices
+          # - Support accounting and finance teams with official billing documents
+          # - Maintain accurate records of billing transactions for audits and compliance
+          #
+          # ### Key response details:
+          #
+          # - The response is a binary PDF file representing the full invoice
+          # - The PDF includes all standard invoice information such as line items, totals,
+          #   billing period, and customer details
+          # - The document is formatted for clarity and professionalism, suitable for
+          #   official use
+          #
+          # ### Usage guidelines:
+          #
+          # - Ensure the `invoice_id` corresponds to an existing invoice for the specified
+          #   `customer_id`
+          # - The PDF is generated on-demand; frequent requests for the same invoice may
+          #   impact performance
+          # - Use appropriate headers to handle the binary response in your application
+          #   (e.g., setting `Content-Type: application/pdf`)
+          #
+          # @overload retrieve_pdf(customer_id:, invoice_id:, request_options: {})
+          #
+          # @param customer_id [String]
+          # @param invoice_id [String]
+          # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [StringIO]
+          #
+          # @see MetronomeSDK::Models::V1::Customers::InvoiceRetrievePdfParams
+          def retrieve_pdf(params)
+            parsed, options = MetronomeSDK::V1::Customers::InvoiceRetrievePdfParams.dump_request(params)
+            customer_id =
+              parsed.delete(:customer_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            invoice_id =
+              parsed.delete(:invoice_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["v1/customers/%1$s/invoices/%2$s/pdf", customer_id, invoice_id],
+              headers: {"accept" => "application/pdf"},
+              model: StringIO,
+              options: options
+            )
+          end
+
           # @api private
           #
           # @param client [MetronomeSDK::Client]

data/lib/metronome_sdk/resources/v1/customers.rb

@@ -176,7 +176,7 @@ module MetronomeSDK
         # - Ingest aliases remain idempotent for archived customers. In order to reuse an
         #   ingest alias, first remove the ingest alias from the customer prior to
         #   archiving.
-        # - Any alerts associated with the customer will no longer be triggered.
+        # - Any notifications associated with the customer will no longer be triggered.
         #
         # @overload archive(id:, request_options: {})
         #
@@ -278,10 +278,10 @@ module MetronomeSDK
         # Some parameter documentations has been truncated, see
         # {MetronomeSDK::Models::V1::CustomerPreviewEventsParams} for more details.
         #
-        # Preview how a set of events will affect a customer's invoice. Generates a draft
-        # invoice for a customer using their current contract configuration and the
+        # Preview how a set of events will affect a customer's invoices. Generates draft
+        # invoices for a customer using their current contract configuration and the
         # provided events. This is useful for testing how new events will affect the
-        # customer's invoice before they are actually processed.
+        # customer's invoices before they are actually processed.
         #
         # @overload preview_events(customer_id:, events:, mode: nil, skip_zero_qty_line_items: nil, request_options: {})
         #
@@ -353,6 +353,9 @@ module MetronomeSDK
         #   through system A (e.g. Stripe) but will now be billed through system B (e.g.
         #   AWS). Once created, the new configuration can then be associated to the
         #   customer's contract.
+        # - Multiple configurations can be added per destination. For example, you can
+        #   create two Stripe billing configurations for a Metronome customer that each
+        #   have a distinct `collection_method`.
         #
         # ### Delivery method options:
         #

data/lib/metronome_sdk/resources/v1/payments.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module MetronomeSDK
+  module Resources
+    class V1
+      class Payments
+        # Fetch all payment attempts for the given invoice.
+        #
+        # @overload list(customer_id:, invoice_id:, limit: nil, next_page: nil, statuses: nil, request_options: {})
+        #
+        # @param customer_id [String]
+        #
+        # @param invoice_id [String]
+        #
+        # @param limit [Integer] The maximum number of payments to return. Defaults to 25.
+        #
+        # @param next_page [String] The next page token from a previous response.
+        #
+        # @param statuses [Array<Symbol, MetronomeSDK::Models::V1::PaymentStatus>]
+        #
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Internal::BodyCursorPage<MetronomeSDK::Models::V1::Payment>]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentListParams
+        def list(params)
+          parsed, options = MetronomeSDK::V1::PaymentListParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/list",
+            body: parsed,
+            page: MetronomeSDK::Internal::BodyCursorPage,
+            model: MetronomeSDK::V1::Payment,
+            options: options
+          )
+        end
+
+        # Trigger a new attempt by canceling any existing attempts for this invoice and
+        # creating a new Payment. This will trigger another attempt to charge the
+        # Customer's configured Payment Gateway. Payment can only be attempted if all of
+        # the following are true:
+        #
+        # - The Metronome Invoice is finalized
+        # - PLG Invoicing is configured for the Customer
+        # - You cannot attempt payments for invoices that have already been `paid` or
+        #   `voided`.
+        #
+        # Attempting to payment on an ineligible Invoice or Customer will result in a
+        # `400` response.
+        #
+        # @overload attempt(customer_id:, invoice_id:, request_options: {})
+        #
+        # @param customer_id [String]
+        # @param invoice_id [String]
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::PaymentAttemptResponse]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentAttemptParams
+        def attempt(params)
+          parsed, options = MetronomeSDK::V1::PaymentAttemptParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/attempt",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::PaymentAttemptResponse,
+            options: options
+          )
+        end
+
+        # Cancel an existing payment attempt for an invoice.
+        #
+        # @overload cancel(customer_id:, invoice_id:, request_options: {})
+        #
+        # @param customer_id [String]
+        # @param invoice_id [String]
+        # @param request_options [MetronomeSDK::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [MetronomeSDK::Models::V1::PaymentCancelResponse]
+        #
+        # @see MetronomeSDK::Models::V1::PaymentCancelParams
+        def cancel(params)
+          parsed, options = MetronomeSDK::V1::PaymentCancelParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/payments/cancel",
+            body: parsed,
+            model: MetronomeSDK::Models::V1::PaymentCancelResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [MetronomeSDK::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/metronome_sdk/resources/v1/usage.rb

@@ -80,8 +80,7 @@ module MetronomeSDK
         # ingestion, supports backdating 34 days, and is built to handle mission-critical
         # usage data with enterprise-grade reliability. Metronome supports 100,000 events
         # per second without requiring pre-aggregation or rollups and can scale up from
-        # there. See
-        # [Getting usage into Metronome](https://docs.metronome.com/connect-metronome/) to
+        # there. See the [Send usage events](/guides/events/send-usage-events) guide to
         # learn more about usage events.
         #
         # ### Use this endpoint to:
@@ -124,6 +123,9 @@ module MetronomeSDK
         # }
         # ```
         #
+        # Learn more about
+        # [usage event structure definitions](/guides/events/design-usage-events).
+        #
         # #### Transaction ID
         #
         # The transaction_id serves as your idempotency key, ensuring events are processed

data/lib/metronome_sdk/resources/v1.rb

@@ -42,6 +42,9 @@ module MetronomeSDK
       # @return [MetronomeSDK::Resources::V1::Contracts]
       attr_reader :contracts
 
+      # @return [MetronomeSDK::Resources::V1::Payments]
+      attr_reader :payments
+
       # @api private
       #
       # @param client [MetronomeSDK::Client]
@@ -60,6 +63,7 @@ module MetronomeSDK
         @services = MetronomeSDK::Resources::V1::Services.new(client: client)
         @invoices = MetronomeSDK::Resources::V1::Invoices.new(client: client)
         @contracts = MetronomeSDK::Resources::V1::Contracts.new(client: client)
+        @payments = MetronomeSDK::Resources::V1::Payments.new(client: client)
       end
     end
   end

data/lib/metronome_sdk/resources/v2/contracts.rb

@@ -128,12 +128,14 @@ module MetronomeSDK
         # - Contract editing must be enabled to use this endpoint. Reach out to your
         #   Metronome representative to learn more.
         #
-        # @overload edit(contract_id:, customer_id:, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, remove_overrides: nil, uniqueness_key: nil, update_commits: nil, update_contract_end_date: nil, update_contract_name: nil, update_credits: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
+        # @overload edit(contract_id:, customer_id:, add_billing_provider_configuration_update: nil, add_commits: nil, add_credits: nil, add_discounts: nil, add_overrides: nil, add_prepaid_balance_threshold_configuration: nil, add_professional_services: nil, add_recurring_commits: nil, add_recurring_credits: nil, add_reseller_royalties: nil, add_scheduled_charges: nil, add_spend_threshold_configuration: nil, add_subscriptions: nil, allow_contract_ending_before_finalized_invoice: nil, archive_commits: nil, archive_credits: nil, archive_scheduled_charges: nil, remove_overrides: nil, uniqueness_key: nil, update_commits: nil, update_contract_end_date: nil, update_contract_name: nil, update_credits: nil, update_prepaid_balance_threshold_configuration: nil, update_recurring_commits: nil, update_recurring_credits: nil, update_scheduled_charges: nil, update_spend_threshold_configuration: nil, update_subscriptions: nil, request_options: {})
         #
         # @param contract_id [String] ID of the contract being edited
         #
         # @param customer_id [String] ID of the customer whose contract is being edited
         #
+        # @param add_billing_provider_configuration_update [MetronomeSDK::Models::V2::ContractEditParams::AddBillingProviderConfigurationUpdate] Update the billing provider configuration on the contract. Currently only suppor
+        #
         # @param add_commits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCommit>]
         #
         # @param add_credits [Array<MetronomeSDK::Models::V2::ContractEditParams::AddCredit>]
@@ -226,7 +228,7 @@ module MetronomeSDK
         #   finalized invoice. You can void the invoice beforehand and then remove the
         #   access schedule segment.
         #
-        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, invoice_contract_id: nil, invoice_schedule: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_commit(commit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, invoice_contract_id: nil, invoice_schedule: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param commit_id [String] ID of the commit to edit
         #
@@ -238,6 +240,8 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the commit applies to. If applicable*product_ids, applicable_product*
         #
+        # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for commit hierarchy access control
+        #
         # @param invoice_contract_id [String] ID of contract to use for invoicing
         #
         # @param invoice_schedule [MetronomeSDK::Models::V2::ContractEditCommitParams::InvoiceSchedule]
@@ -286,7 +290,7 @@ module MetronomeSDK
         #   invoice. You can void the invoice beforehand and then remove the access
         #   schedule segment.
         #
-        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
+        # @overload edit_credit(credit_id:, customer_id:, access_schedule: nil, applicable_product_ids: nil, applicable_product_tags: nil, hierarchy_configuration: nil, priority: nil, product_id: nil, rate_type: nil, specifiers: nil, request_options: {})
         #
         # @param credit_id [String] ID of the credit to edit
         #
@@ -298,6 +302,8 @@ module MetronomeSDK
         #
         # @param applicable_product_tags [Array<String>, nil] Which tags the credit applies to. If both applicable*product_ids and applicable*
         #
+        # @param hierarchy_configuration [MetronomeSDK::Models::CommitHierarchyConfiguration] Optional configuration for credit hierarchy access control
+        #
         # @param priority [Float, nil] If multiple commits are applicable, the one with the lower priority will apply f
         #
         # @param product_id [String]

data/lib/metronome_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetronomeSDK
-  VERSION = "1.0.0"
+  VERSION = "2.0.0"
 end

data/lib/metronome_sdk.rb

@@ -221,6 +221,7 @@ require_relative "metronome_sdk/models/v1/customers/invoice_list_breakdowns_para
 require_relative "metronome_sdk/models/v1/customers/invoice_list_breakdowns_response"
 require_relative "metronome_sdk/models/v1/customers/invoice_list_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_params"
+require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_pdf_params"
 require_relative "metronome_sdk/models/v1/customers/invoice_retrieve_response"
 require_relative "metronome_sdk/models/v1/customers/named_schedule_retrieve_params"
 require_relative "metronome_sdk/models/v1/customers/named_schedule_retrieve_response"
@@ -250,6 +251,13 @@ require_relative "metronome_sdk/models/v1/invoice_regenerate_params"
 require_relative "metronome_sdk/models/v1/invoice_regenerate_response"
 require_relative "metronome_sdk/models/v1/invoice_void_params"
 require_relative "metronome_sdk/models/v1/invoice_void_response"
+require_relative "metronome_sdk/models/v1/payment"
+require_relative "metronome_sdk/models/v1/payment_attempt_params"
+require_relative "metronome_sdk/models/v1/payment_attempt_response"
+require_relative "metronome_sdk/models/v1/payment_cancel_params"
+require_relative "metronome_sdk/models/v1/payment_cancel_response"
+require_relative "metronome_sdk/models/v1/payment_list_params"
+require_relative "metronome_sdk/models/v1/payment_status"
 require_relative "metronome_sdk/models/v1/plan_detail"
 require_relative "metronome_sdk/models/v1/plan_get_details_params"
 require_relative "metronome_sdk/models/v1/plan_get_details_response"
@@ -308,6 +316,7 @@ require_relative "metronome_sdk/resources/v1/customers/plans"
 require_relative "metronome_sdk/resources/v1/custom_fields"
 require_relative "metronome_sdk/resources/v1/dashboards"
 require_relative "metronome_sdk/resources/v1/invoices"
+require_relative "metronome_sdk/resources/v1/payments"
 require_relative "metronome_sdk/resources/v1/plans"
 require_relative "metronome_sdk/resources/v1/pricing_units"
 require_relative "metronome_sdk/resources/v1/services"

data/rbi/metronome_sdk/errors.rbi

@@ -33,6 +33,9 @@ module MetronomeSDK
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -41,6 +44,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -50,6 +54,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -70,6 +75,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -79,6 +85,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -93,6 +100,7 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -102,6 +110,7 @@ module MetronomeSDK
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -116,13 +125,22 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -133,13 +151,22 @@ module MetronomeSDK
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/metronome_sdk/file_part.rbi

@@ -27,7 +27,7 @@ module MetronomeSDK
     sig do
       params(
         content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(String),
+        filename: T.nilable(T.any(Pathname, String)),
         content_type: T.nilable(String)
       ).returns(T.attached_class)
     end