chargebee 2.74.0 → 2.77.0

data/lib/chargebee/models/usage.rb

@@ -13,14 +13,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("subscriptions",id.to_s,"usages"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("subscriptions",id.to_s,"usages"), params, env, headers,nil, false, jsonKeys, options, "usage", "create")
   end
 
   def self.retrieve(id, params, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("subscriptions",id.to_s,"usages"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("subscriptions",id.to_s,"usages"), params, env, headers,nil, false, jsonKeys, options, "usage", "retrieve")
   end
 
   def self.delete(id, params, env=nil, headers={})
@@ -29,14 +29,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("subscriptions",id.to_s,"delete_usage"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("subscriptions",id.to_s,"delete_usage"), params, env, headers,nil, false, jsonKeys, options, "usage", "delete")
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send_list_request('get', uri_path("usages"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send_list_request('get', uri_path("usages"), params, env, headers,nil, false, jsonKeys, options, "usage", "list")
   end
 
   def self.pdf(params, env=nil, headers={})
@@ -45,7 +45,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("usages","pdf"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("usages","pdf"), params, env, headers,nil, false, jsonKeys, options, "usage", "pdf")
   end
 
   end # ~Usage

data/lib/chargebee/models/usage_charge.rb

@@ -11,7 +11,7 @@ module ChargeBee
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("subscriptions",id.to_s,"usage_charges"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("subscriptions",id.to_s,"usage_charges"), params, env, headers,nil, false, jsonKeys, options, "usageCharge", "retrieveUsageChargesForSubscription")
   end
 
   end # ~UsageCharge

data/lib/chargebee/models/usage_event.rb

@@ -11,7 +11,7 @@ module ChargeBee
         :properties => 0,
     }
     options = {}
-    Request.send('post', uri_path("usage_events"), params, env, headers, "ingest", true, jsonKeys, options)
+    Request.send('post', uri_path("usage_events"), params, env, headers, "ingest", true, jsonKeys, options, "usageEvent", "create")
   end
 
   def self.batch_ingest(params, env=nil, headers={})
@@ -19,7 +19,7 @@ module ChargeBee
         :properties => 1,
     }
     options = {}
-    Request.send('post', uri_path("batch","usage_events"), params, env, headers, "ingest", true, jsonKeys, options)
+    Request.send('post', uri_path("batch","usage_events"), params, env, headers, "ingest", true, jsonKeys, options, "usageEvent", "batchIngest")
   end
 
   end # ~UsageEvent

data/lib/chargebee/models/usage_file.rb

@@ -16,14 +16,14 @@ module ChargeBee
     jsonKeys = { 
     }
     options = {}
-    Request.send('post', uri_path("usage_files","upload_url"), params, env, headers, "file-ingest", false, jsonKeys, options)
+    Request.send('post', uri_path("usage_files","upload_url"), params, env, headers, "file-ingest", false, jsonKeys, options, "usageFile", "uploadUrl")
   end
 
   def self.processing_status(id, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("usage_files",id.to_s,"processing_status"), {}, env, headers, "file-ingest", false, jsonKeys, options)
+    Request.send('get', uri_path("usage_files",id.to_s,"processing_status"), {}, env, headers, "file-ingest", false, jsonKeys, options, "usageFile", "processingStatus")
   end
 
   end # ~UsageFile

data/lib/chargebee/models/usage_summary.rb

@@ -10,7 +10,7 @@ module ChargeBee
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("subscriptions",id.to_s,"usage_summary"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("subscriptions",id.to_s,"usage_summary"), params, env, headers,nil, false, jsonKeys, options, "usageSummary", "retrieveUsageSummaryForSubscription")
   end
 
   end # ~UsageSummary

data/lib/chargebee/models/virtual_bank_account.rb

@@ -14,7 +14,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts","create_using_permanent_token"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts","create_using_permanent_token"), params, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "createUsingPermanentToken")
   end
 
   def self.create(params, env=nil, headers={})
@@ -23,21 +23,21 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "create")
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("virtual_bank_accounts",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("virtual_bank_accounts",id.to_s), {}, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "retrieve")
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send_list_request('get', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send_list_request('get', uri_path("virtual_bank_accounts"), params, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "list")
   end
 
   def self.delete(id, env=nil, headers={})
@@ -46,7 +46,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "delete")
   end
 
   def self.delete_local(id, env=nil, headers={})
@@ -55,7 +55,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete_local"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("virtual_bank_accounts",id.to_s,"delete_local"), {}, env, headers,nil, false, jsonKeys, options, "virtualBankAccount", "deleteLocal")
   end
 
   end # ~VirtualBankAccount

data/lib/chargebee/models/webhook_endpoint.rb

@@ -13,7 +13,7 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options, "webhookEndpoint", "create")
   end
 
   def self.update(id, params={}, env=nil, headers={})
@@ -22,14 +22,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints",id.to_s), params, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints",id.to_s), params, env, headers,nil, false, jsonKeys, options, "webhookEndpoint", "update")
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send('get', uri_path("webhook_endpoints",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('get', uri_path("webhook_endpoints",id.to_s), {}, env, headers,nil, false, jsonKeys, options, "webhookEndpoint", "retrieve")
   end
 
   def self.delete(id, env=nil, headers={})
@@ -38,14 +38,14 @@ module ChargeBee
     options = {
         :isIdempotent => true
       }
-    Request.send('post', uri_path("webhook_endpoints",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
+    Request.send('post', uri_path("webhook_endpoints",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options, "webhookEndpoint", "delete")
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
     options = {}
-    Request.send_list_request('get', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options)
+    Request.send_list_request('get', uri_path("webhook_endpoints"), params, env, headers,nil, false, jsonKeys, options, "webhookEndpoint", "list")
   end
 
   end # ~WebhookEndpoint

data/lib/chargebee/request.rb

@@ -1,7 +1,7 @@
 module ChargeBee
   class Request
 
-    def self.send_list_request(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={})
+    def self.send_list_request(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={}, telemetry_resource=nil, telemetry_operation=nil)
       serialized = {}
       params.each do |k, v|
         if(v.kind_of? Array)
@@ -9,19 +9,48 @@ module ChargeBee
         end
         serialized["#{k}"] = v
       end
-      self.send(method, url, serialized, env, headers, sub_domain, isJsonRequest=nil, jsonKeys={}, options)
+      self.send(method, url, serialized, env, headers, sub_domain, isJsonRequest, jsonKeys, options, telemetry_resource, telemetry_operation)
     end
 
-    def self.send(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={})
+    def self.send(method, url, params={}, env=nil, headers={}, sub_domain=nil, isJsonRequest=nil, jsonKeys={}, options={}, telemetry_resource=nil, telemetry_operation=nil)
+      telemetry_resource, telemetry_operation = normalize_telemetry_args(telemetry_resource, telemetry_operation)
       env ||= ChargeBee.default_env
       ser_params = isJsonRequest ? params : Util.serialize(params, nil, nil, jsonKeys)
-      resp, rheaders, rcode = NativeRequest.request(method, url, env, ser_params||={}, headers, sub_domain, isJsonRequest, options)
-      if resp&.has_key?(:list)
-        ListResult.new(resp[:list], resp[:next_offset], rheaders, rcode)
-      else
-        Result.new(resp, rheaders, rcode)
+      http_url = TelemetryExecutor.build_http_url(env, sub_domain, url)
+      normalized_headers = headers || {}
+
+      TelemetryExecutor.execute(
+        env,
+        telemetry_resource: telemetry_resource,
+        telemetry_operation: telemetry_operation,
+        method: method,
+        http_url: http_url,
+        request_headers: normalized_headers,
+      ) do |telemetry_headers|
+        merged_headers = normalized_headers.dup
+        if telemetry_headers
+          telemetry_headers.each { |key, value| merged_headers[key] = value }
+        end
+        resp, rheaders, rcode = NativeRequest.request(method, url, env, ser_params||={}, merged_headers, sub_domain, isJsonRequest, options)
+        result = if resp && resp.has_key?(:list)
+          ListResult.new(resp[:list], resp[:next_offset], rheaders, rcode)
+        else
+          Result.new(resp, rheaders, rcode)
+        end
+        [rcode.to_i, result]
       end
     end
 
+    def self.normalize_telemetry_args(telemetry_resource, telemetry_operation)
+      if telemetry_resource.is_a?(Hash) && telemetry_operation.nil? &&
+         (telemetry_resource.key?(:telemetry_resource) || telemetry_resource.key?(:telemetry_operation))
+        h = telemetry_resource
+        return [h[:telemetry_resource], h[:telemetry_operation]]
+      end
+
+      [telemetry_resource, telemetry_operation]
+    end
+    private_class_method :normalize_telemetry_args
+
   end
 end

data/lib/chargebee/result.rb

@@ -30,6 +30,20 @@ module ChargeBee
         end
     end
 
+    def async_response_list() 
+        async_response_list = get(:async_response_list, AsyncResponseList, {},
+        {:list => AsyncResponse});
+        async_response_list.init_dependant_list(@response[:async_response_list], :list,
+        {:request => AsyncResponse::RequestAsyncApi, :error_detail => AsyncResponse::Error});
+        return async_response_list;
+    end
+
+    def async_response() 
+        async_response = get(:async_response, AsyncResponse,
+        {:request_async_api => AsyncResponse::RequestAsyncApi, :error => AsyncResponse::Error});
+        return async_response;
+    end
+
     def subscription() 
         subscription = get(:subscription, Subscription,
         {:subscription_items => Subscription::SubscriptionItem, :item_tiers => Subscription::ItemTier, :charged_items => Subscription::ChargedItem, :addons => Subscription::Addon, :event_based_addons => Subscription::EventBasedAddon, :charged_event_based_addons => Subscription::ChargedEventBasedAddon, :coupons => Subscription::Coupon, :shipping_address => Subscription::ShippingAddress, :referral_info => Subscription::ReferralInfo, :billing_override => Subscription::BillingOverride, :contract_term => Subscription::ContractTerm, :discounts => Subscription::Discount});
@@ -106,7 +120,7 @@ module ChargeBee
 
     def invoice() 
         invoice = get(:invoice, Invoice,
-        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
+        {:exchange_rates => Invoice::ExchangeRate, :line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
         return invoice;
     end
 
@@ -133,7 +147,7 @@ module ChargeBee
 
     def credit_note() 
         credit_note = get(:credit_note, CreditNote,
-        {:line_items => CreditNote::LineItem, :line_item_tiers => CreditNote::LineItemTier, :line_item_discounts => CreditNote::LineItemDiscount, :line_item_taxes => CreditNote::LineItemTax, :line_item_addresses => CreditNote::LineItemAddress, :discounts => CreditNote::Discount, :taxes => CreditNote::Tax, :tax_origin => CreditNote::TaxOrigin, :linked_refunds => CreditNote::LinkedRefund, :allocations => CreditNote::Allocation, :shipping_address => CreditNote::ShippingAddress, :billing_address => CreditNote::BillingAddress, :einvoice => CreditNote::Einvoice, :site_details_at_creation => CreditNote::SiteDetailsAtCreation});
+        {:line_items => CreditNote::LineItem, :line_item_tiers => CreditNote::LineItemTier, :line_item_discounts => CreditNote::LineItemDiscount, :line_item_taxes => CreditNote::LineItemTax, :line_item_addresses => CreditNote::LineItemAddress, :discounts => CreditNote::Discount, :taxes => CreditNote::Tax, :tax_origin => CreditNote::TaxOrigin, :linked_refunds => CreditNote::LinkedRefund, :allocations => CreditNote::Allocation, :exchange_rates => CreditNote::ExchangeRate, :shipping_address => CreditNote::ShippingAddress, :billing_address => CreditNote::BillingAddress, :einvoice => CreditNote::Einvoice, :site_details_at_creation => CreditNote::SiteDetailsAtCreation});
         return credit_note;
     end
 
@@ -318,7 +332,7 @@ module ChargeBee
 
     def payment_intent() 
         payment_intent = get(:payment_intent, PaymentIntent,
-        {:payment_attempt => PaymentIntent::PaymentAttempt, :payment_attempts => PaymentIntent::PaymentAttempt});
+        {:payment_attempt => PaymentIntent::PaymentAttempt, :payment_attempts => PaymentIntent::PaymentAttempt, :payment_intent_metadata => PaymentIntent::PaymentIntentMetadata});
         return payment_intent;
     end
 
@@ -530,11 +544,31 @@ module ChargeBee
         return rule;
     end
 
+    def meter() 
+        meter = get(:meter, Meter, {},
+        {:column_definitions => ColumnDefinition, :features => Feature});
+        meter.init_dependant_list(@response[:meter], :column_definitions,
+        {});
+        meter.init_dependant_list(@response[:meter], :features,
+        {:levels => Feature::Level});
+        return meter;
+    end
+
     def usage_event() 
         usage_event = get(:usage_event, UsageEvent);
         return usage_event;
     end
 
+    def metered_feature() 
+        metered_feature = get(:metered_feature, MeteredFeature, {},
+        {:column_definitions => ColumnDefinition, :features => Feature});
+        metered_feature.init_dependant_list(@response[:metered_feature], :column_definitions,
+        {});
+        metered_feature.init_dependant_list(@response[:metered_feature], :features,
+        {:levels => Feature::Level});
+        return metered_feature;
+    end
+
     def usage_file() 
         usage_file = get(:usage_file, UsageFile,
         {:upload_detail => UsageFile::UploadDetail});
@@ -579,7 +613,8 @@ module ChargeBee
     end
 
     def alert() 
-        alert = get(:alert, Alert);
+        alert = get(:alert, Alert,
+        {:threshold => Alert::Threshold, :filter_conditions => Alert::FilterCondition});
         return alert;
     end
 
@@ -644,7 +679,7 @@ module ChargeBee
 
     def invoices() 
         invoices = get_list(:invoices, Invoice,
-        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
+        {:exchange_rates => Invoice::ExchangeRate, :line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
         return invoices;
     end
 
@@ -656,7 +691,7 @@ module ChargeBee
 
     def credit_notes() 
         credit_notes = get_list(:credit_notes, CreditNote,
-        {:line_items => CreditNote::LineItem, :line_item_tiers => CreditNote::LineItemTier, :line_item_discounts => CreditNote::LineItemDiscount, :line_item_taxes => CreditNote::LineItemTax, :line_item_addresses => CreditNote::LineItemAddress, :discounts => CreditNote::Discount, :taxes => CreditNote::Tax, :tax_origin => CreditNote::TaxOrigin, :linked_refunds => CreditNote::LinkedRefund, :allocations => CreditNote::Allocation, :shipping_address => CreditNote::ShippingAddress, :billing_address => CreditNote::BillingAddress, :einvoice => CreditNote::Einvoice, :site_details_at_creation => CreditNote::SiteDetailsAtCreation});
+        {:line_items => CreditNote::LineItem, :line_item_tiers => CreditNote::LineItemTier, :line_item_discounts => CreditNote::LineItemDiscount, :line_item_taxes => CreditNote::LineItemTax, :line_item_addresses => CreditNote::LineItemAddress, :discounts => CreditNote::Discount, :taxes => CreditNote::Tax, :tax_origin => CreditNote::TaxOrigin, :linked_refunds => CreditNote::LinkedRefund, :allocations => CreditNote::Allocation, :exchange_rates => CreditNote::ExchangeRate, :shipping_address => CreditNote::ShippingAddress, :billing_address => CreditNote::BillingAddress, :einvoice => CreditNote::Einvoice, :site_details_at_creation => CreditNote::SiteDetailsAtCreation});
         return credit_notes;
     end
 

data/lib/chargebee/telemetry/request_telemetry_context.rb

@@ -0,0 +1,29 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Context passed to TelemetryAdapter#on_request_start.
+    class RequestTelemetryContext
+      attr_reader :span_name, :resource, :operation, :http_method, :http_url, :server_address,
+                  :chargebee_site, :chargebee_api_version, :sdk_name, :sdk_version, :start_attributes
+
+      def initialize(span_name:, resource:, operation:, http_method:, http_url:, server_address:,
+                     chargebee_site:, chargebee_api_version:, sdk_name:, sdk_version:, start_attributes:)
+        @span_name = span_name
+        @resource = resource
+        @operation = operation
+        @http_method = http_method
+        @http_url = http_url
+        @server_address = server_address
+        @chargebee_site = chargebee_site
+        @chargebee_api_version = chargebee_api_version
+        @sdk_name = sdk_name
+        @sdk_version = sdk_version
+        @start_attributes = start_attributes.freeze
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/request_telemetry_error.rb

@@ -0,0 +1,20 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Error details attached to RequestTelemetryResult on failed requests.
+    class RequestTelemetryError
+      attr_reader :message, :chargebee_error_code, :chargebee_api_error_type, :chargebee_error_param
+
+      def initialize(message:, chargebee_error_code: nil, chargebee_api_error_type: nil, chargebee_error_param: nil)
+        @message = message
+        @chargebee_error_code = chargebee_error_code
+        @chargebee_api_error_type = chargebee_api_error_type
+        @chargebee_error_param = chargebee_error_param
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/request_telemetry_result.rb

@@ -0,0 +1,20 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Result passed to TelemetryAdapter#on_request_end.
+    class RequestTelemetryResult
+      attr_reader :http_status_code, :duration_ms, :error, :end_attributes
+
+      def initialize(http_status_code:, duration_ms:, error:, end_attributes:)
+        @http_status_code = http_status_code
+        @duration_ms = duration_ms
+        @error = error
+        @end_attributes = end_attributes.freeze
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_adapter.rb

@@ -0,0 +1,32 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Optional telemetry adapter for observability integrations (e.g. OpenTelemetry).
+    #
+    # When not configured, the SDK skips all telemetry work — zero overhead. The SDK stores the
+    # adapter by reference and never clones or deep-copies it.
+    #
+    # Implementations may inject W3C trace context headers (traceparent, tracestate) into
+    # request_headers during on_request_start.
+    module TelemetryAdapter
+      # Called once per SDK API call before the request is sent (including before retries).
+      #
+      # context contains prebuilt start attributes. request_headers is a mutable map for trace propagation.
+      # Returns an opaque handle passed back to on_request_end, or nil if span creation was skipped.
+      def on_request_start(context, request_headers)
+        raise NotImplementedError
+      end
+
+      # Called once per SDK API call after the final response or terminal failure.
+      #
+      # handle is the value returned from on_request_start and may be nil. result contains prebuilt end attributes.
+      def on_request_end(handle, result)
+        raise NotImplementedError
+      end
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_attribute_keys.rb

@@ -0,0 +1,33 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Span attribute keys shared across Chargebee SDKs.
+    module TelemetryAttributeKeys
+      SDK_NAME = 'chargebee-ruby'.freeze
+      TELEMETRY_SPAN_NAME_PREFIX = 'chargebee'.freeze
+
+      HTTP_REQUEST_HEADER_ATTRIBUTE_PREFIX = 'http.request.header.'.freeze
+      CHARGEBEE_TELEMETRY_HEADER_PREFIX = 'chargebee-'.freeze
+      CHARGEBEE_TELEMETRY_HEADER_EXCLUDE_PREFIX = 'chargebee-request-origin-'.freeze
+
+      URL_FULL = 'url.full'.freeze
+      HTTP_REQUEST_METHOD = 'http.request.method'.freeze
+      HTTP_RESPONSE_STATUS_CODE = 'http.response.status_code'.freeze
+      SERVER_ADDRESS = 'server.address'.freeze
+      ERROR_TYPE = 'error.type'.freeze
+      CHARGEBEE_SITE = 'chargebee.site'.freeze
+      CHARGEBEE_API_VERSION = 'chargebee.api_version'.freeze
+      CHARGEBEE_RESOURCE = 'chargebee.resource'.freeze
+      CHARGEBEE_OPERATION = 'chargebee.operation'.freeze
+      CHARGEBEE_SDK_NAME = 'chargebee.sdk.name'.freeze
+      CHARGEBEE_SDK_VERSION = 'chargebee.sdk.version'.freeze
+      CHARGEBEE_ERROR_CODE = 'chargebee.error.code'.freeze
+      CHARGEBEE_ERROR_TYPE = 'chargebee.error.type'.freeze
+      CHARGEBEE_ERROR_PARAM = 'chargebee.error.param'.freeze
+    end
+  end
+end

data/lib/chargebee/telemetry/telemetry_support.rb

@@ -0,0 +1,123 @@
+# This file is auto-generated by Chargebee.
+# For more information on how to make changes to this file, please see the README.
+# Reach out to dx@chargebee.com for any questions.
+# Copyright 2026 Chargebee Inc.
+
+module ChargeBee
+  module Telemetry
+    # Helpers for building standardized Chargebee telemetry context and results.
+    class TelemetrySupport
+      class << self
+        def build_span_name(resource, operation)
+          "#{TelemetryAttributeKeys::TELEMETRY_SPAN_NAME_PREFIX}.#{resource}.#{operation}"
+        end
+
+        def resolve_chargebee_api_version(api_path)
+          api_path == '/api/v1' ? 'v1' : 'v2'
+        end
+
+        def build_request_start_span_attributes(resource, operation, http_method, http_url, server_address,
+                                                chargebee_site, chargebee_api_version, sdk_version, request_headers = {})
+          {
+            TelemetryAttributeKeys::URL_FULL => http_url,
+            TelemetryAttributeKeys::HTTP_REQUEST_METHOD => http_method,
+            TelemetryAttributeKeys::SERVER_ADDRESS => server_address,
+            TelemetryAttributeKeys::CHARGEBEE_SITE => chargebee_site,
+            TelemetryAttributeKeys::CHARGEBEE_API_VERSION => chargebee_api_version,
+            TelemetryAttributeKeys::CHARGEBEE_RESOURCE => resource,
+            TelemetryAttributeKeys::CHARGEBEE_OPERATION => operation,
+            TelemetryAttributeKeys::CHARGEBEE_SDK_NAME => TelemetryAttributeKeys::SDK_NAME,
+            TelemetryAttributeKeys::CHARGEBEE_SDK_VERSION => sdk_version,
+          }.merge(build_request_header_span_attributes(request_headers))
+        end
+
+        # Promotes chargebee-* request headers to http.request.header.* attributes; excludes the chargebee-request-origin-* PII family.
+        def build_request_header_span_attributes(request_headers)
+          attributes = {}
+          return attributes if request_headers.nil?
+
+          request_headers.each do |name, value|
+            next if name.nil? || value.nil?
+
+            lower_name = name.to_s.downcase
+            next unless lower_name.start_with?(TelemetryAttributeKeys::CHARGEBEE_TELEMETRY_HEADER_PREFIX)
+            next if lower_name.start_with?(TelemetryAttributeKeys::CHARGEBEE_TELEMETRY_HEADER_EXCLUDE_PREFIX)
+
+            attributes["#{TelemetryAttributeKeys::HTTP_REQUEST_HEADER_ATTRIBUTE_PREFIX}#{lower_name}"] = value.to_s
+          end
+
+          attributes
+        end
+
+        def build_request_end_span_attributes(http_status_code, error)
+          attributes = {
+            TelemetryAttributeKeys::HTTP_RESPONSE_STATUS_CODE => http_status_code,
+          }
+
+          if error
+            if error.chargebee_api_error_type
+              attributes[TelemetryAttributeKeys::ERROR_TYPE] = error.chargebee_api_error_type
+              attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_TYPE] = error.chargebee_api_error_type
+            end
+            attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_CODE] = error.chargebee_error_code if error.chargebee_error_code
+            attributes[TelemetryAttributeKeys::CHARGEBEE_ERROR_PARAM] = error.chargebee_error_param if error.chargebee_error_param
+          end
+
+          attributes
+        end
+
+        def build_request_telemetry_context(resource, operation, http_method, http_url, server_address,
+                                            chargebee_site, chargebee_api_version, sdk_version, request_headers = {})
+          RequestTelemetryContext.new(
+            span_name: build_span_name(resource, operation),
+            resource: resource,
+            operation: operation,
+            http_method: http_method,
+            http_url: http_url,
+            server_address: server_address,
+            chargebee_site: chargebee_site,
+            chargebee_api_version: chargebee_api_version,
+            sdk_name: TelemetryAttributeKeys::SDK_NAME,
+            sdk_version: sdk_version,
+            start_attributes: build_request_start_span_attributes(
+              resource, operation, http_method, http_url, server_address, chargebee_site, chargebee_api_version, sdk_version, request_headers
+            ),
+          )
+        end
+
+        def build_request_telemetry_result(http_status_code, duration_ms, error)
+          RequestTelemetryResult.new(
+            http_status_code: http_status_code,
+            duration_ms: duration_ms,
+            error: error,
+            end_attributes: build_request_end_span_attributes(http_status_code, error),
+          )
+        end
+
+        def extract_request_telemetry_error(err)
+          return nil if err.nil?
+
+          message = err.message.to_s
+          message = 'Chargebee API request failed' if message.empty?
+
+          if err.is_a?(ChargeBee::APIError)
+            return RequestTelemetryError.new(
+              message: message,
+              chargebee_error_code: err.api_error_code,
+              chargebee_api_error_type: err.type.to_s,
+              chargebee_error_param: err.param,
+            )
+          end
+
+          RequestTelemetryError.new(message: message)
+        end
+
+        def extract_http_status_code(err)
+          return err.http_status_code if err.is_a?(ChargeBee::APIError)
+
+          nil
+        end
+      end
+    end
+  end
+end