Merge upstream and update generated code for v2026 and 2025-09-30.preview

lib/stripe/api_resource.rb

@@ -111,6 +111,9 @@ module Stripe
       )
     end
 
+    # Retrieve by passing id like `retrieve(id)`
+    # If passing parameters, pass a single map with parameters and the `id` as well.
+    # For example: retrieve({id: some_id, some_param: some_param_value})
     def self.retrieve(id, opts = {})
       if name.include?("Stripe::V2")
         raise NotImplementedError,