stripe 18.2.0.pre.alpha.1 → 18.2.0.pre.alpha.2

data/lib/stripe/resources/quote.rb

@@ -732,7 +732,7 @@ module Stripe
       attr_reader :from_subscription
       # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on the subscription or subscription schedule when the quote is accepted. If a recurring price is included in `line_items`, this field will be passed to the resulting subscription's `metadata` field. If `subscription_data.effective_date` is used, this field will be passed to the resulting subscription schedule's `phases.metadata` field. Unlike object-level metadata, this field is declarative. Updates will clear prior values.
       attr_reader :metadata
-      # Configures how the quote handles billing for line transitions. Possible values are `line_start` (default) or `billing_period_start`. `line_start` bills based on the current state of the line, ignoring changes scheduled for future lines. `billing_period_start` bills predictively for upcoming line transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted.
       attr_reader :phase_effective_at
       # If specified, the invoicing for the given billing cycle iterations will be processed when the quote is accepted. Cannot be used with `effective_date`.
       attr_reader :prebilling
@@ -991,7 +991,7 @@ module Stripe
       attr_reader :description
       # Behavior of the subscription schedule and underlying subscription when it ends.
       attr_reader :end_behavior
-      # Configures how the quote handles billing for line transitions. Possible values are `line_start` (default) or `billing_period_start`. `line_start` bills based on the current state of the line, ignoring changes scheduled for future lines. `billing_period_start` bills predictively for upcoming line transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+      # Configures how the subscription schedule handles billing for phase transitions when the quote is accepted.
       attr_reader :phase_effective_at
       # Determines how to handle [prorations](https://docs.stripe.com/subscriptions/billing-cycle#prorations) when the quote is accepted.
       attr_reader :proration_behavior

data/lib/stripe/resources/quote_line.rb

@@ -489,7 +489,7 @@ module Stripe
     attr_reader :billing_cycle_anchor
     # A point-in-time operation that cancels an existing subscription schedule at the line's starts_at timestamp. Currently only compatible with `quote_acceptance_date` for `starts_at`. When using cancel_subscription_schedule, the subscription schedule on the quote remains unalterable, except for modifications to the metadata, collection_method or invoice_settings.
     attr_reader :cancel_subscription_schedule
-    # Configures how the subscription schedule handles billing for phase transitions. Possible values are `phase_start` (default) or `billing_period_start`. `phase_start` bills based on the current state of the subscription, ignoring changes scheduled in future phases. `billing_period_start` bills predictively for upcoming phase transitions within the current billing cycle, including pricing changes and service period adjustments that will occur before the next invoice.
+    # Configures how the subscription schedule handles billing for phase transitions.
     attr_reader :effective_at
     # Details to identify the end of the time range modified by the proposed change. If not supplied, the quote line is considered a point-in-time operation that only affects the exact timestamp at `starts_at`, and a restricted set of attributes is supported on the quote line.
     attr_reader :ends_at

data/lib/stripe/resources/quote_preview_invoice.rb

@@ -367,6 +367,8 @@ module Stripe
       class ScheduleDetails < ::Stripe::StripeObject
         # The schedule that generated this invoice
         attr_reader :schedule
+        # The subscription associated with this schedule
+        attr_reader :subscription
 
         def self.inner_class_types
           @inner_class_types = {}

data/lib/stripe/resources/shared_payment/granted_token.rb

@@ -94,7 +94,7 @@ module Stripe
         end
 
         # Revokes a test SharedPaymentGrantedToken object. This endpoint is only available in test mode and allows sellers to revoke SharedPaymentGrantedTokens for testing their integration
-        def self.update(shared_payment_granted_token, params = {}, opts = {})
+        def self.revoke(shared_payment_granted_token, params = {}, opts = {})
           request_stripe_object(
             method: :post,
             path: format("/v1/test_helpers/shared_payment/granted_tokens/%<shared_payment_granted_token>s/revoke", { shared_payment_granted_token: CGI.escape(shared_payment_granted_token) }),
@@ -104,7 +104,7 @@ module Stripe
         end
 
         # Revokes a test SharedPaymentGrantedToken object. This endpoint is only available in test mode and allows sellers to revoke SharedPaymentGrantedTokens for testing their integration
-        def update(params = {}, opts = {})
+        def revoke(params = {}, opts = {})
           @resource.request_stripe_object(
             method: :post,
             path: format("/v1/test_helpers/shared_payment/granted_tokens/%<shared_payment_granted_token>s/revoke", { shared_payment_granted_token: CGI.escape(@resource["id"]) }),

data/lib/stripe/resources/subscription.rb

@@ -936,6 +936,26 @@ module Stripe
       )
     end
 
+    # Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+    def pause(params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/pause", { subscription: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    # Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+    def self.pause(subscription, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/pause", { subscription: CGI.escape(subscription) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def resume(params = {}, opts = {})
       request_stripe_object(

data/lib/stripe/resources/tax/calculation_line_item.rb

@@ -90,6 +90,8 @@ module Stripe
       attr_reader :tax_breakdown
       # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
       attr_reader :tax_code
+      # A tax location for a line item that acts as a performance location. This indicates that the line item might be taxed at the place where it is being performed at. This is helpful for events or other services being performed at non-customer addresses like venues or offices. This can be left empty for tax codes that do not require a tax location. For tax codes where the location requirement is "optional", this would override the customer address in most use cases.
+      attr_reader :performance_location
 
       def self.inner_class_types
         @inner_class_types = { tax_breakdown: TaxBreakdown }

data/lib/stripe/resources/tax/location.rb

@@ -0,0 +1,72 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # Tax locations represent venues for services, tickets, or other product types.
+    class Location < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "tax.location"
+      def self.object_name
+        "tax.location"
+      end
+
+      class Address < ::Stripe::StripeObject
+        # City, district, suburb, town, or village.
+        attr_reader :city
+        # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+        attr_reader :country
+        # Address line 1, such as the street, PO Box, or company name.
+        attr_reader :line1
+        # Address line 2, such as the apartment, suite, unit, or building.
+        attr_reader :line2
+        # ZIP or postal code.
+        attr_reader :postal_code
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
+        attr_reader :state
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field address
+      attr_reader :address
+      # A descriptive text providing additional context about the tax location. This can include information about the venue, types of events held, services available, or any relevant details for better identification (e.g., "A spacious auditorium suitable for large concerts and events.").
+      attr_reader :description
+      # Unique identifier for the object.
+      attr_reader :id
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The type of tax location to be defined. Currently the only option is `performance`.
+      attr_reader :type
+
+      # Create a tax location to use in calculating taxes for a service, ticket, or other type of product. The resulting object contains the id, address, name, description, and current operational status of the tax location.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(method: :post, path: "/v1/tax/locations", params: params, opts: opts)
+      end
+
+      # Retrieve a list of all tax locations. Tax locations can represent the venues for services, tickets, or other product types.
+      #
+      # The response includes detailed information for each tax location, such as its address, name, description, and current operational status.
+      #
+      # You can paginate through the list by using the limit parameter to control the number of results returned in each request.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(method: :get, path: "/v1/tax/locations", params: params, opts: opts)
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { address: Address }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax/registration.rb

@@ -1733,6 +1733,71 @@ module Stripe
         end
 
         class Us < ::Stripe::StripeObject
+          class AdmissionsTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=admissions_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class AttendanceTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=attendance_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class EntertainmentTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=entertainment_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class GrossReceiptsTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=gross_receipts_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class HospitalityTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=hospitality_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
           class LocalAmusementTax < ::Stripe::StripeObject
             # A [FIPS code](https://www.census.gov/library/reference/code-lists/ansi.html) representing the local jurisdiction.
             attr_reader :jurisdiction
@@ -1759,6 +1824,32 @@ module Stripe
             end
           end
 
+          class LuxuryTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=luxury_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
+          class ResortTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=resort_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+
           class StateSalesTax < ::Stripe::StripeObject
             class Election < ::Stripe::StripeObject
               # A [FIPS code](https://www.census.gov/library/reference/code-lists/ansi.html) representing the local jurisdiction.
@@ -1785,6 +1876,19 @@ module Stripe
               @field_remappings = {}
             end
           end
+
+          class TourismTax < ::Stripe::StripeObject
+            # A [jurisdiction code](https://docs.stripe.com/tax/registering?type=tourism_tax#registration-types) representing the local jurisdiction.
+            attr_reader :jurisdiction
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
           # Attribute for field local_amusement_tax
           attr_reader :local_amusement_tax
           # Attribute for field local_lease_tax
@@ -1795,12 +1899,36 @@ module Stripe
           attr_reader :state_sales_tax
           # Type of registration in the US.
           attr_reader :type
+          # Attribute for field admissions_tax
+          attr_reader :admissions_tax
+          # Attribute for field attendance_tax
+          attr_reader :attendance_tax
+          # Attribute for field entertainment_tax
+          attr_reader :entertainment_tax
+          # Attribute for field gross_receipts_tax
+          attr_reader :gross_receipts_tax
+          # Attribute for field hospitality_tax
+          attr_reader :hospitality_tax
+          # Attribute for field luxury_tax
+          attr_reader :luxury_tax
+          # Attribute for field resort_tax
+          attr_reader :resort_tax
+          # Attribute for field tourism_tax
+          attr_reader :tourism_tax
 
           def self.inner_class_types
             @inner_class_types = {
               local_amusement_tax: LocalAmusementTax,
               local_lease_tax: LocalLeaseTax,
               state_sales_tax: StateSalesTax,
+              admissions_tax: AdmissionsTax,
+              attendance_tax: AttendanceTax,
+              entertainment_tax: EntertainmentTax,
+              gross_receipts_tax: GrossReceiptsTax,
+              hospitality_tax: HospitalityTax,
+              luxury_tax: LuxuryTax,
+              resort_tax: ResortTax,
+              tourism_tax: TourismTax,
             }
           end
 

data/lib/stripe/resources/tax_code.rb

@@ -11,6 +11,18 @@ module Stripe
       "tax_code"
     end
 
+    class Requirements < ::Stripe::StripeObject
+      # Describes whether a performance location is required for a successful tax calculation with a tax code.
+      attr_reader :performance_location
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
     # A detailed description of which types of products the tax code represents.
     attr_reader :description
     # Unique identifier for the object.
@@ -19,6 +31,8 @@ module Stripe
     attr_reader :name
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
+    # An object that describes more information about the tax location required for this tax code. Some [tax codes](/tax/tax-for-tickets/integration-guide#types-of-products) require a tax location of type `performance` to calculate tax correctly.
+    attr_reader :requirements
 
     # A list of [all tax codes available](https://stripe.com/docs/tax/tax-categories) to add to Products in order to allow specific tax calculations.
     def self.list(params = {}, opts = {})
@@ -26,7 +40,7 @@ module Stripe
     end
 
     def self.inner_class_types
-      @inner_class_types = {}
+      @inner_class_types = { requirements: Requirements }
     end
 
     def self.field_remappings

data/lib/stripe/resources.rb

@@ -144,6 +144,7 @@ require "stripe/resources/tax/association"
 require "stripe/resources/tax/calculation"
 require "stripe/resources/tax/calculation_line_item"
 require "stripe/resources/tax/form"
+require "stripe/resources/tax/location"
 require "stripe/resources/tax/registration"
 require "stripe/resources/tax/settings"
 require "stripe/resources/tax/transaction"

data/lib/stripe/services/subscription_service.rb

@@ -79,6 +79,17 @@ module Stripe
       )
     end
 
+    # Pauses a subscription by transitioning it to the paused status. A paused subscription does not generate invoices and will not advance to new billing periods. The subscription can be resumed later using the resume endpoint. Cannot pause subscriptions with attached schedules.
+    def pause(subscription, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/subscriptions/%<subscription>s/pause", { subscription: CGI.escape(subscription) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
     # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def resume(subscription, params = {}, opts = {})
       request(

data/lib/stripe/services/tax/location_service.rb

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    class LocationService < StripeService
+      # Create a tax location to use in calculating taxes for a service, ticket, or other type of product. The resulting object contains the id, address, name, description, and current operational status of the tax location.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/tax/locations",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Retrieve a list of all tax locations. Tax locations can represent the venues for services, tickets, or other product types.
+      #
+      # The response includes detailed information for each tax location, such as its address, name, description, and current operational status.
+      #
+      # You can paginate through the list by using the limit parameter to control the number of results returned in each request.
+      def list(params = {}, opts = {})
+        request(
+          method: :get,
+          path: "/v1/tax/locations",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Fetch the details of a specific tax location using its unique identifier. Use a tax location to calculate taxes based on the location of the end product, such as a performance, instead of the customer address. For more details, check the [integration guide](https://docs.stripe.com/tax/tax-for-tickets/integration-guide).
+      def retrieve(location, params = {}, opts = {})
+        request(
+          method: :get,
+          path: format("/v1/tax/locations/%<location>s", { location: CGI.escape(location) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end

data/lib/stripe/services/tax_service.rb

@@ -3,13 +3,14 @@
 
 module Stripe
   class TaxService < StripeService
-    attr_reader :associations, :calculations, :forms, :registrations, :settings, :transactions
+    attr_reader :associations, :calculations, :forms, :locations, :registrations, :settings, :transactions
 
     def initialize(requestor)
       super
       @associations = Stripe::Tax::AssociationService.new(@requestor)
       @calculations = Stripe::Tax::CalculationService.new(@requestor)
       @forms = Stripe::Tax::FormService.new(@requestor)
+      @locations = Stripe::Tax::LocationService.new(@requestor)
       @registrations = Stripe::Tax::RegistrationService.new(@requestor)
       @settings = Stripe::Tax::SettingsService.new(@requestor)
       @transactions = Stripe::Tax::TransactionService.new(@requestor)

data/lib/stripe/services/test_helpers/shared_payment/granted_token_service.rb

@@ -17,7 +17,7 @@ module Stripe
         end
 
         # Revokes a test SharedPaymentGrantedToken object. This endpoint is only available in test mode and allows sellers to revoke SharedPaymentGrantedTokens for testing their integration
-        def update(shared_payment_granted_token, params = {}, opts = {})
+        def revoke(shared_payment_granted_token, params = {}, opts = {})
           request(
             method: :post,
             path: format("/v1/test_helpers/shared_payment/granted_tokens/%<shared_payment_granted_token>s/revoke", { shared_payment_granted_token: CGI.escape(shared_payment_granted_token) }),

data/lib/stripe/services.rb

@@ -159,6 +159,7 @@ require "stripe/services/tax/association_service"
 require "stripe/services/tax/calculation_line_item_service"
 require "stripe/services/tax/calculation_service"
 require "stripe/services/tax/form_service"
+require "stripe/services/tax/location_service"
 require "stripe/services/tax/registration_service"
 require "stripe/services/tax/settings_service"
 require "stripe/services/tax/transaction_line_item_service"

data/lib/stripe/util.rb

@@ -7,16 +7,22 @@ module Stripe
     LEGAL_FIRST_CHARACTER = /[a-zA-Z_]/.freeze
     LEGAL_VARIABLE_CHARACTER = /[a-zA-Z0-9_]/.freeze
 
-    def self.objects_to_ids(obj)
+    def self.objects_to_ids(obj, semantics)
       case obj
       when APIResource
         obj.id
       when Hash
         res = {}
-        obj.each { |k, v| res[k] = objects_to_ids(v) unless v.nil? }
+        obj.each do |k, v|
+          if !v.nil?
+            res[k] = objects_to_ids(v, semantics)
+          elsif semantics == :v2
+            res[k] = nil
+          end
+        end
         res
       when Array
-        obj.map { |v| objects_to_ids(v) }
+        obj.map { |v| objects_to_ids(v, semantics) }
       else
         obj
       end

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "18.2.0-alpha.1"
+  VERSION = "18.2.0-alpha.2"
 end