stripe 18.1.0.pre.beta.1 → 18.1.0

data/lib/stripe/resources/subscription.rb

@@ -4,7 +4,7 @@
 module Stripe
   # Subscriptions allow you to charge a customer on a recurring basis.
   #
-  # Related guide: [Creating subscriptions](https://stripe.com/docs/billing/subscriptions/creating)
+  # Related guide: [Creating subscriptions](https://docs.stripe.com/billing/subscriptions/creating)
   class Subscription < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -97,70 +97,6 @@ module Stripe
       end
     end
 
-    class BillingSchedule < ::Stripe::StripeObject
-      class AppliesTo < ::Stripe::StripeObject
-        # The billing schedule will apply to the subscription item with the given price ID.
-        attr_reader :price
-        # Controls which subscription items the billing schedule applies to.
-        attr_reader :type
-
-        def self.inner_class_types
-          @inner_class_types = {}
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-
-      class BillUntil < ::Stripe::StripeObject
-        class Duration < ::Stripe::StripeObject
-          # Specifies billing duration. Either `day`, `week`, `month` or `year`.
-          attr_reader :interval
-          # The multiplier applied to the interval.
-          attr_reader :interval_count
-
-          def self.inner_class_types
-            @inner_class_types = {}
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-        # The timestamp the billing schedule will apply until.
-        attr_reader :computed_timestamp
-        # Specifies the billing period.
-        attr_reader :duration
-        # If specified, the billing schedule will apply until the specified timestamp.
-        attr_reader :timestamp
-        # Describes how the billing schedule will determine the end date. Either `duration` or `timestamp`.
-        attr_reader :type
-
-        def self.inner_class_types
-          @inner_class_types = { duration: Duration }
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-      # Specifies which subscription items the billing schedule applies to.
-      attr_reader :applies_to
-      # Specifies the end of billing period.
-      attr_reader :bill_until
-      # Unique identifier for the billing schedule.
-      attr_reader :key
-
-      def self.inner_class_types
-        @inner_class_types = { applies_to: AppliesTo, bill_until: BillUntil }
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-
     class BillingThresholds < ::Stripe::StripeObject
       # Monetary threshold that triggers the subscription to create an invoice
       attr_reader :amount_gte
@@ -222,37 +158,6 @@ module Stripe
       end
     end
 
-    class LastPriceMigrationError < ::Stripe::StripeObject
-      class FailedTransition < ::Stripe::StripeObject
-        # The original price to be migrated.
-        attr_reader :source_price
-        # The intended resulting price of the migration.
-        attr_reader :target_price
-
-        def self.inner_class_types
-          @inner_class_types = {}
-        end
-
-        def self.field_remappings
-          @field_remappings = {}
-        end
-      end
-      # The time at which the price migration encountered an error.
-      attr_reader :errored_at
-      # The involved price pairs in each failed transition.
-      attr_reader :failed_transitions
-      # The type of error encountered by the price migration.
-      attr_reader :type
-
-      def self.inner_class_types
-        @inner_class_types = { failed_transitions: FailedTransition }
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-
     class PauseCollection < ::Stripe::StripeObject
       # The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
       attr_reader :behavior
@@ -331,7 +236,7 @@ module Stripe
           attr_reader :mandate_options
           # Selected network to process this Subscription on. Depends on the available networks of the card attached to the Subscription. Can be only set confirm-time.
           attr_reader :network
-          # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
+          # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://docs.stripe.com/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Read our guide on [manually requesting 3D Secure](https://docs.stripe.com/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
           attr_reader :request_three_d_secure
 
           def self.inner_class_types
@@ -384,16 +289,6 @@ module Stripe
           end
         end
 
-        class IdBankTransfer < ::Stripe::StripeObject
-          def self.inner_class_types
-            @inner_class_types = {}
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-
         class Konbini < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
@@ -404,16 +299,14 @@ module Stripe
           end
         end
 
-        class Pix < ::Stripe::StripeObject
+        class Payto < ::Stripe::StripeObject
           class MandateOptions < ::Stripe::StripeObject
-            # Amount to be charged for future payments.
+            # The maximum amount that can be collected in a single invoice. If you don't specify a maximum, then there is no limit.
             attr_reader :amount
-            # Determines if the amount includes the IOF tax.
-            attr_reader :amount_includes_iof
-            # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`.
-            attr_reader :end_date
-            # Schedule at which the future payments will be charged.
-            attr_reader :payment_schedule
+            # Only `maximum` is supported.
+            attr_reader :amount_type
+            # The purpose for which payments are made. Has a default value based on your merchant category code.
+            attr_reader :purpose
 
             def self.inner_class_types
               @inner_class_types = {}
@@ -445,44 +338,11 @@ module Stripe
           end
         end
 
-        class Upi < ::Stripe::StripeObject
-          class MandateOptions < ::Stripe::StripeObject
-            # Amount to be charged for future payments.
-            attr_reader :amount
-            # One of `fixed` or `maximum`. If `fixed`, the `amount` param refers to the exact amount to be charged in future payments. If `maximum`, the amount charged can be up to the value passed for the `amount` param.
-            attr_reader :amount_type
-            # A description of the mandate or subscription that is meant to be displayed to the customer.
-            attr_reader :description
-            # End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
-            attr_reader :end_date
-
-            def self.inner_class_types
-              @inner_class_types = {}
-            end
-
-            def self.field_remappings
-              @field_remappings = {}
-            end
-          end
-          # Attribute for field mandate_options
-          attr_reader :mandate_options
-
-          def self.inner_class_types
-            @inner_class_types = { mandate_options: MandateOptions }
-          end
-
-          def self.field_remappings
-            @field_remappings = {}
-          end
-        end
-
         class UsBankAccount < ::Stripe::StripeObject
           class FinancialConnections < ::Stripe::StripeObject
             class Filters < ::Stripe::StripeObject
               # The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
               attr_reader :account_subcategories
-              # The institution to use to filter for possible accounts to link.
-              attr_reader :institution
 
               def self.inner_class_types
                 @inner_class_types = {}
@@ -528,16 +388,12 @@ module Stripe
         attr_reader :card
         # This sub-hash contains details about the Bank transfer payment method options to pass to invoices created by the subscription.
         attr_reader :customer_balance
-        # This sub-hash contains details about the Indonesia bank transfer payment method options to pass to invoices created by the subscription.
-        attr_reader :id_bank_transfer
         # This sub-hash contains details about the Konbini payment method options to pass to invoices created by the subscription.
         attr_reader :konbini
-        # This sub-hash contains details about the Pix payment method options to pass to invoices created by the subscription.
-        attr_reader :pix
+        # This sub-hash contains details about the PayTo payment method options to pass to invoices created by the subscription.
+        attr_reader :payto
         # This sub-hash contains details about the SEPA Direct Debit payment method options to pass to invoices created by the subscription.
         attr_reader :sepa_debit
-        # This sub-hash contains details about the UPI payment method options to pass to invoices created by the subscription.
-        attr_reader :upi
         # This sub-hash contains details about the ACH direct debit payment method options to pass to invoices created by the subscription.
         attr_reader :us_bank_account
 
@@ -547,11 +403,9 @@ module Stripe
             bancontact: Bancontact,
             card: Card,
             customer_balance: CustomerBalance,
-            id_bank_transfer: IdBankTransfer,
             konbini: Konbini,
-            pix: Pix,
+            payto: Payto,
             sepa_debit: SepaDebit,
-            upi: Upi,
             us_bank_account: UsBankAccount,
           }
         end
@@ -596,13 +450,11 @@ module Stripe
       attr_reader :billing_cycle_anchor
       # The point after which the changes reflected by this update will be discarded and no longer applied.
       attr_reader :expires_at
-      # The number of iterations of prebilling to apply.
-      attr_reader :prebilling_iterations
       # List of subscription items, each with an attached plan, that will be set if the update is applied.
       attr_reader :subscription_items
       # Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.
       attr_reader :trial_end
-      # Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
+      # Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://docs.stripe.com/billing/subscriptions/trials) to learn more.
       attr_reader :trial_from_plan
 
       def self.inner_class_types
@@ -614,25 +466,6 @@ module Stripe
       end
     end
 
-    class Prebilling < ::Stripe::StripeObject
-      # ID of the prebilling invoice.
-      attr_reader :invoice
-      # The end of the last period for which the invoice pre-bills.
-      attr_reader :period_end
-      # The start of the first period for which the invoice pre-bills.
-      attr_reader :period_start
-      # Whether to cancel or preserve `prebilling` if the subscription is updated during the prebilled period.
-      attr_reader :update_behavior
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-
     class TransferData < ::Stripe::StripeObject
       # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
       attr_reader :amount_percent
@@ -678,16 +511,12 @@ module Stripe
     attr_reader :application_fee_percent
     # Attribute for field automatic_tax
     attr_reader :automatic_tax
-    # The Billing Cadence which controls the timing of recurring invoice generation for this subscription.If unset, the subscription will bill according to its own configured schedule and create its own invoices.If set, this subscription will be billed by the cadence instead, potentially sharing invoices with the other subscriptions linked to that Cadence.
-    attr_reader :billing_cadence
-    # The reference point that aligns future [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle) dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. The timestamp is in UTC format.
+    # The reference point that aligns future [billing cycle](https://docs.stripe.com/subscriptions/billing-cycle) dates. It sets the day of week for `week` intervals, the day of month for `month` and `year` intervals, and the month of year for `year` intervals. The timestamp is in UTC format.
     attr_reader :billing_cycle_anchor
     # The fixed values used to calculate the `billing_cycle_anchor`.
     attr_reader :billing_cycle_anchor_config
     # The billing mode of the subscription.
     attr_reader :billing_mode
-    # Billing schedules for this subscription.
-    attr_reader :billing_schedules
     # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period
     attr_reader :billing_thresholds
     # A date in the future at which the subscription will automatically get canceled
@@ -706,13 +535,13 @@ module Stripe
     attr_reader :currency
     # ID of the customer who owns the subscription.
     attr_reader :customer
-    # ID of the account who owns the subscription.
+    # ID of the account representing the customer who owns the subscription.
     attr_reader :customer_account
     # Number of days a customer has to pay invoices generated by this subscription. This value will be `null` for subscriptions where `collection_method=charge_automatically`.
     attr_reader :days_until_due
-    # ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source).
+    # ID of the default payment method for the subscription. It must belong to the customer associated with the subscription. This takes precedence over `default_source`. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source).
     attr_reader :default_payment_method
-    # ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://stripe.com/docs/api/customers/object#customer_object-default_source).
+    # ID of the default payment source for the subscription. It must belong to the customer associated with the subscription and be in a chargeable state. If `default_payment_method` is also set, `default_payment_method` will take precedence. If neither are set, invoices will use the customer's [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) or [default_source](https://docs.stripe.com/api/customers/object#customer_object-default_source).
     attr_reader :default_source
     # The tax rates that will apply to any subscription item that does not have `tax_rates` set. Invoices created will have their `default_tax_rates` populated from the subscription.
     attr_reader :default_tax_rates
@@ -728,32 +557,28 @@ module Stripe
     attr_reader :invoice_settings
     # List of subscription items, each with an attached price.
     attr_reader :items
-    # Details of the most recent price migration that failed for the subscription.
-    attr_reader :last_price_migration_error
     # The most recent invoice this subscription has generated.
     attr_reader :latest_invoice
     # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
     attr_reader :livemode
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # Specifies the approximate timestamp on which any pending invoice items will be billed according to the schedule provided at `pending_invoice_item_interval`.
     attr_reader :next_pending_invoice_item_invoice
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # The account (if any) the charge was made on behalf of for charges associated with this subscription. See the [Connect documentation](https://stripe.com/docs/connect/subscriptions#on-behalf-of) for details.
+    # The account (if any) the charge was made on behalf of for charges associated with this subscription. See the [Connect documentation](https://docs.stripe.com/connect/subscriptions#on-behalf-of) for details.
     attr_reader :on_behalf_of
-    # If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
+    # If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment).
     attr_reader :pause_collection
     # Payment settings passed on to invoices created by the subscription.
     attr_reader :payment_settings
-    # Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://stripe.com/docs/api#create_invoice) for the given subscription at the specified interval.
+    # Specifies an interval for how often to bill for any pending invoice items. It is analogous to calling [Create an invoice](https://docs.stripe.com/api#create_invoice) for the given subscription at the specified interval.
     attr_reader :pending_invoice_item_interval
-    # You can use this [SetupIntent](https://stripe.com/docs/api/setup_intents) to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication#scenario-2).
+    # You can use this [SetupIntent](https://docs.stripe.com/api/setup_intents) to collect user authentication when creating a subscription without immediate payment or updating a subscription's payment method, allowing you to optimize for off-session payments. Learn more in the [SCA Migration Guide](https://docs.stripe.com/billing/migration/strong-customer-authentication#scenario-2).
     attr_reader :pending_setup_intent
-    # If specified, [pending updates](https://stripe.com/docs/billing/subscriptions/pending-updates) that will be applied to the subscription once the `latest_invoice` has been paid.
+    # If specified, [pending updates](https://docs.stripe.com/billing/subscriptions/pending-updates) that will be applied to the subscription once the `latest_invoice` has been paid.
     attr_reader :pending_update
-    # Time period and invoice for a Subscription billed in advance.
-    attr_reader :prebilling
     # The schedule attached to the subscription
     attr_reader :schedule
     # Date when the subscription was first created. The date might differ from the `created` date due to backdating.
@@ -764,7 +589,7 @@ module Stripe
     #
     # A subscription that is currently in a trial period is `trialing` and moves to `active` when the trial period is over.
     #
-    # A subscription can only enter a `paused` status [when a trial ends without a payment method](https://stripe.com/docs/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged.
+    # A subscription can only enter a `paused` status [when a trial ends without a payment method](https://docs.stripe.com/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://docs.stripe.com/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged.
     #
     # If subscription `collection_method=charge_automatically`, it becomes `past_due` when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will become `canceled` or `unpaid` (depending on your subscriptions settings).
     #
@@ -781,26 +606,6 @@ module Stripe
     # If the subscription has a trial, the beginning of that trial.
     attr_reader :trial_start
 
-    # Attach a Billing Cadence to an existing subscription. When attached, the subscription is billed by the Billing Cadence, potentially sharing invoices with the other subscriptions linked to the Billing Cadence.
-    def attach_cadence(params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/subscriptions/%<subscription>s/attach_cadence", { subscription: CGI.escape(self["id"]) }),
-        params: params,
-        opts: opts
-      )
-    end
-
-    # Attach a Billing Cadence to an existing subscription. When attached, the subscription is billed by the Billing Cadence, potentially sharing invoices with the other subscriptions linked to the Billing Cadence.
-    def self.attach_cadence(subscription, params = {}, opts = {})
-      request_stripe_object(
-        method: :post,
-        path: format("/v1/subscriptions/%<subscription>s/attach_cadence", { subscription: CGI.escape(subscription) }),
-        params: params,
-        opts: opts
-      )
-    end
-
     # Cancels a customer's subscription immediately. The customer won't be charged again for the subscription. After it's canceled, you can no longer update the subscription or its [metadata](https://docs.stripe.com/metadata).
     #
     # Any pending invoice items that you've created are still charged at the end of the period, unless manually [deleted](https://docs.stripe.com/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations are also left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations are removed if invoice_now and prorate are both set to true.
@@ -955,16 +760,13 @@ module Stripe
         automatic_tax: AutomaticTax,
         billing_cycle_anchor_config: BillingCycleAnchorConfig,
         billing_mode: BillingMode,
-        billing_schedules: BillingSchedule,
         billing_thresholds: BillingThresholds,
         cancellation_details: CancellationDetails,
         invoice_settings: InvoiceSettings,
-        last_price_migration_error: LastPriceMigrationError,
         pause_collection: PauseCollection,
         payment_settings: PaymentSettings,
         pending_invoice_item_interval: PendingInvoiceItemInterval,
         pending_update: PendingUpdate,
-        prebilling: Prebilling,
         transfer_data: TransferData,
         trial_settings: TrialSettings,
       }

data/lib/stripe/resources/subscription_item.rb

@@ -27,23 +27,6 @@ module Stripe
         @field_remappings = {}
       end
     end
-
-    class Trial < ::Stripe::StripeObject
-      # List of price IDs which, if present on the subscription following a paid trial, constitute opting-in to the paid trial.
-      attr_reader :converts_to
-      # Determines the type of trial for this item.
-      attr_reader :type
-
-      def self.inner_class_types
-        @inner_class_types = {}
-      end
-
-      def self.field_remappings
-        @field_remappings = {}
-      end
-    end
-    # The time period the subscription item has been billed for.
-    attr_reader :billed_until
     # Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period
     attr_reader :billing_thresholds
     # Time at which the object was created. Measured in seconds since the Unix epoch.
@@ -56,34 +39,32 @@ module Stripe
     attr_reader :discounts
     # Unique identifier for the object.
     attr_reader :id
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+    # You can now model subscriptions more flexibly using the [Prices API](https://api.stripe.com#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
     #
     # Plans define the base price, currency, and billing cycle for recurring purchases of products.
-    # [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme.
+    # [Products](https://api.stripe.com#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme.
     #
     # For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year.
     #
-    # Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview).
+    # Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription) and more about [products and prices](https://docs.stripe.com/products-prices/overview).
     attr_reader :plan
     # Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products.
-    # [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme.
+    # [Products](https://api.stripe.com#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme.
     #
     # For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once.
     #
-    # Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview).
+    # Related guides: [Set up a subscription](https://docs.stripe.com/billing/subscriptions/set-up-subscription), [create an invoice](https://docs.stripe.com/billing/invoices/create), and more about [products and prices](https://docs.stripe.com/products-prices/overview).
     attr_reader :price
-    # The [quantity](https://stripe.com/docs/subscriptions/quantities) of the plan to which the customer should be subscribed.
+    # The [quantity](https://docs.stripe.com/subscriptions/quantities) of the plan to which the customer should be subscribed.
     attr_reader :quantity
     # The `subscription` this `subscription_item` belongs to.
     attr_reader :subscription
     # The tax rates which apply to this `subscription_item`. When set, the `default_tax_rates` on the subscription do not apply to this `subscription_item`.
     attr_reader :tax_rates
-    # Options that configure the trial on the subscription item.
-    attr_reader :trial
     # Always true for a deleted object
     attr_reader :deleted
 
@@ -138,7 +119,7 @@ module Stripe
     end
 
     def self.inner_class_types
-      @inner_class_types = { billing_thresholds: BillingThresholds, trial: Trial }
+      @inner_class_types = { billing_thresholds: BillingThresholds }
     end
 
     def self.field_remappings