stripe 17.0.1 → 19.0.0

data/lib/stripe/params/invoice_create_preview_params.rb

@@ -2,9 +2,9 @@
 # frozen_string_literal: true
 
 module Stripe
-  class InvoiceCreatePreviewParams < Stripe::RequestParams
-    class AutomaticTax < Stripe::RequestParams
-      class Liability < Stripe::RequestParams
+  class InvoiceCreatePreviewParams < ::Stripe::RequestParams
+    class AutomaticTax < ::Stripe::RequestParams
+      class Liability < ::Stripe::RequestParams
         # The connected account being referenced when `type` is `account`.
         attr_accessor :account
         # Type of the account referenced in the request.
@@ -15,7 +15,7 @@ module Stripe
           @type = type
         end
       end
-      # Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://stripe.com/docs/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
+      # Whether Stripe automatically computes tax on this invoice. Note that incompatible invoice items (invoice items with manually specified [tax rates](https://docs.stripe.com/api/tax_rates), negative amounts, or `tax_behavior=unspecified`) cannot be added to automatic tax invoices.
       attr_accessor :enabled
       # The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
       attr_accessor :liability
@@ -26,8 +26,8 @@ module Stripe
       end
     end
 
-    class CustomerDetails < Stripe::RequestParams
-      class Address < Stripe::RequestParams
+    class CustomerDetails < ::Stripe::RequestParams
+      class Address < ::Stripe::RequestParams
         # City, district, suburb, town, or village.
         attr_accessor :city
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -38,7 +38,7 @@ module Stripe
         attr_accessor :line2
         # ZIP or postal code.
         attr_accessor :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_accessor :state
 
         def initialize(
@@ -58,8 +58,8 @@ module Stripe
         end
       end
 
-      class Shipping < Stripe::RequestParams
-        class Address < Stripe::RequestParams
+      class Shipping < ::Stripe::RequestParams
+        class Address < ::Stripe::RequestParams
           # City, district, suburb, town, or village.
           attr_accessor :city
           # A freeform text field for the country. However, in order to activate some tax features, the format should be a two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -70,7 +70,7 @@ module Stripe
           attr_accessor :line2
           # ZIP or postal code.
           attr_accessor :postal_code
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           attr_accessor :state
 
           def initialize(
@@ -103,7 +103,7 @@ module Stripe
         end
       end
 
-      class Tax < Stripe::RequestParams
+      class Tax < ::Stripe::RequestParams
         # A recent IP address of the customer used for tax reporting and tax location inference. Stripe recommends updating the IP address when a new PaymentMethod is attached or the address field on the customer is updated. We recommend against updating this field more frequently since it could result in unexpected tax location/reporting outcomes.
         attr_accessor :ip_address
 
@@ -112,8 +112,8 @@ module Stripe
         end
       end
 
-      class TaxId < Stripe::RequestParams
-        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
+      class TaxId < ::Stripe::RequestParams
+        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `lk_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
         attr_accessor :type
         # Value of the tax ID.
         attr_accessor :value
@@ -123,7 +123,7 @@ module Stripe
           @value = value
         end
       end
-      # The customer's address.
+      # The customer's address. Learn about [country-specific requirements for calculating tax](/invoicing/taxes?dashboard-or-api=dashboard#set-up-customer).
       attr_accessor :address
       # The customer's shipping information. Appears on invoices emailed to this customer.
       attr_accessor :shipping
@@ -143,7 +143,7 @@ module Stripe
       end
     end
 
-    class Discount < Stripe::RequestParams
+    class Discount < ::Stripe::RequestParams
       # ID of the coupon to create a new discount for.
       attr_accessor :coupon
       # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -158,8 +158,8 @@ module Stripe
       end
     end
 
-    class InvoiceItem < Stripe::RequestParams
-      class Discount < Stripe::RequestParams
+    class InvoiceItem < ::Stripe::RequestParams
+      class Discount < ::Stripe::RequestParams
         # ID of the coupon to create a new discount for.
         attr_accessor :coupon
         # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -174,7 +174,7 @@ module Stripe
         end
       end
 
-      class Period < Stripe::RequestParams
+      class Period < ::Stripe::RequestParams
         # The end of the period, which must be greater than or equal to the start. This value is inclusive.
         attr_accessor :end
         # The start of the period. This value is inclusive.
@@ -186,12 +186,12 @@ module Stripe
         end
       end
 
-      class PriceData < Stripe::RequestParams
+      class PriceData < ::Stripe::RequestParams
         # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
         attr_accessor :currency
         # The ID of the [Product](https://docs.stripe.com/api/products) that this [Price](https://docs.stripe.com/api/prices) will belong to.
         attr_accessor :product
-        # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+        # Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
         attr_accessor :tax_behavior
         # A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
         attr_accessor :unit_amount
@@ -211,6 +211,10 @@ module Stripe
           @unit_amount = unit_amount
           @unit_amount_decimal = unit_amount_decimal
         end
+
+        def self.field_encodings
+          @field_encodings = { unit_amount_decimal: :decimal_string }
+        end
       end
       # The integer amount in cents (or local equivalent) of previewed invoice item.
       attr_accessor :amount
@@ -224,19 +228,21 @@ module Stripe
       attr_accessor :discounts
       # The ID of the invoice item to update in preview. If not specified, a new invoice item will be added to the preview of the upcoming invoice.
       attr_accessor :invoiceitem
-      # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+      # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
       attr_accessor :metadata
-      # The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://stripe.com/docs/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://stripe.com/docs/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
+      # The period associated with this invoice item. When set to different values, the period will be rendered on the invoice. If you have [Stripe Revenue Recognition](https://docs.stripe.com/revenue-recognition) enabled, the period will be used to recognize and defer revenue. See the [Revenue Recognition documentation](https://docs.stripe.com/revenue-recognition/methodology/subscriptions-and-invoicing) for details.
       attr_accessor :period
       # The ID of the price object. One of `price` or `price_data` is required.
       attr_accessor :price
-      # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+      # Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
       attr_accessor :price_data
-      # Non-negative integer. The quantity of units for the invoice item.
+      # Non-negative integer. The quantity of units for the invoice item. Use `quantity_decimal` instead to provide decimal precision. This field will be deprecated in favor of `quantity_decimal` in a future version.
       attr_accessor :quantity
-      # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+      # Non-negative decimal with at most 12 decimal places. The quantity of units for the invoice item.
+      attr_accessor :quantity_decimal
+      # Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
       attr_accessor :tax_behavior
-      # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+      # A [tax code](https://docs.stripe.com/tax/tax-categories) ID.
       attr_accessor :tax_code
       # The tax rates that apply to the item. When set, any `default_tax_rates` do not apply to this item.
       attr_accessor :tax_rates
@@ -257,6 +263,7 @@ module Stripe
         price: nil,
         price_data: nil,
         quantity: nil,
+        quantity_decimal: nil,
         tax_behavior: nil,
         tax_code: nil,
         tax_rates: nil,
@@ -274,15 +281,24 @@ module Stripe
         @price = price
         @price_data = price_data
         @quantity = quantity
+        @quantity_decimal = quantity_decimal
         @tax_behavior = tax_behavior
         @tax_code = tax_code
         @tax_rates = tax_rates
         @unit_amount = unit_amount
         @unit_amount_decimal = unit_amount_decimal
       end
+
+      def self.field_encodings
+        @field_encodings = {
+          price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+          quantity_decimal: :decimal_string,
+          unit_amount_decimal: :decimal_string,
+        }
+      end
     end
 
-    class Issuer < Stripe::RequestParams
+    class Issuer < ::Stripe::RequestParams
       # The connected account being referenced when `type` is `account`.
       attr_accessor :account
       # Type of the account referenced in the request.
@@ -294,9 +310,9 @@ module Stripe
       end
     end
 
-    class ScheduleDetails < Stripe::RequestParams
-      class BillingMode < Stripe::RequestParams
-        class Flexible < Stripe::RequestParams
+    class ScheduleDetails < ::Stripe::RequestParams
+      class BillingMode < ::Stripe::RequestParams
+        class Flexible < ::Stripe::RequestParams
           # Controls how invoices and invoice items display proration amounts and discount amounts.
           attr_accessor :proration_discounts
 
@@ -315,9 +331,9 @@ module Stripe
         end
       end
 
-      class Phase < Stripe::RequestParams
-        class AddInvoiceItem < Stripe::RequestParams
-          class Discount < Stripe::RequestParams
+      class Phase < ::Stripe::RequestParams
+        class AddInvoiceItem < ::Stripe::RequestParams
+          class Discount < ::Stripe::RequestParams
             # ID of the coupon to create a new discount for.
             attr_accessor :coupon
             # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -332,8 +348,8 @@ module Stripe
             end
           end
 
-          class Period < Stripe::RequestParams
-            class End < Stripe::RequestParams
+          class Period < ::Stripe::RequestParams
+            class End < ::Stripe::RequestParams
               # A precise Unix timestamp for the end of the invoice item period. Must be greater than or equal to `period.start`.
               attr_accessor :timestamp
               # Select how to calculate the end of the invoice item period.
@@ -345,7 +361,7 @@ module Stripe
               end
             end
 
-            class Start < Stripe::RequestParams
+            class Start < ::Stripe::RequestParams
               # A precise Unix timestamp for the start of the invoice item period. Must be less than or equal to `period.end`.
               attr_accessor :timestamp
               # Select how to calculate the start of the invoice item period.
@@ -367,12 +383,12 @@ module Stripe
             end
           end
 
-          class PriceData < Stripe::RequestParams
+          class PriceData < ::Stripe::RequestParams
             # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
             attr_accessor :currency
             # The ID of the [Product](https://docs.stripe.com/api/products) that this [Price](https://docs.stripe.com/api/prices) will belong to.
             attr_accessor :product
-            # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+            # Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
             attr_accessor :tax_behavior
             # A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge or a negative integer representing the amount to credit to the customer.
             attr_accessor :unit_amount
@@ -392,16 +408,20 @@ module Stripe
               @unit_amount = unit_amount
               @unit_amount_decimal = unit_amount_decimal
             end
+
+            def self.field_encodings
+              @field_encodings = { unit_amount_decimal: :decimal_string }
+            end
           end
           # The coupons to redeem into discounts for the item.
           attr_accessor :discounts
-          # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+          # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
           attr_accessor :metadata
           # The period associated with this invoice item. If not set, `period.start.type` defaults to `max_item_period_start` and `period.end.type` defaults to `min_item_period_end`.
           attr_accessor :period
           # The ID of the price object. One of `price` or `price_data` is required.
           attr_accessor :price
-          # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+          # Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
           attr_accessor :price_data
           # Quantity for this item. Defaults to 1.
           attr_accessor :quantity
@@ -425,10 +445,16 @@ module Stripe
             @quantity = quantity
             @tax_rates = tax_rates
           end
+
+          def self.field_encodings
+            @field_encodings = {
+              price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+            }
+          end
         end
 
-        class AutomaticTax < Stripe::RequestParams
-          class Liability < Stripe::RequestParams
+        class AutomaticTax < ::Stripe::RequestParams
+          class Liability < ::Stripe::RequestParams
             # The connected account being referenced when `type` is `account`.
             attr_accessor :account
             # Type of the account referenced in the request.
@@ -450,7 +476,7 @@ module Stripe
           end
         end
 
-        class BillingThresholds < Stripe::RequestParams
+        class BillingThresholds < ::Stripe::RequestParams
           # Monetary threshold that triggers the subscription to advance to a new billing period
           attr_accessor :amount_gte
           # Indicates if the `billing_cycle_anchor` should be reset when a threshold is reached. If true, `billing_cycle_anchor` will be updated to the date/time the threshold was last reached; otherwise, the value will remain unchanged.
@@ -462,7 +488,7 @@ module Stripe
           end
         end
 
-        class Discount < Stripe::RequestParams
+        class Discount < ::Stripe::RequestParams
           # ID of the coupon to create a new discount for.
           attr_accessor :coupon
           # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -477,7 +503,7 @@ module Stripe
           end
         end
 
-        class Duration < Stripe::RequestParams
+        class Duration < ::Stripe::RequestParams
           # Specifies phase duration. Either `day`, `week`, `month` or `year`.
           attr_accessor :interval
           # The multiplier applied to the interval.
@@ -489,8 +515,8 @@ module Stripe
           end
         end
 
-        class InvoiceSettings < Stripe::RequestParams
-          class Issuer < Stripe::RequestParams
+        class InvoiceSettings < ::Stripe::RequestParams
+          class Issuer < ::Stripe::RequestParams
             # The connected account being referenced when `type` is `account`.
             attr_accessor :account
             # Type of the account referenced in the request.
@@ -515,9 +541,9 @@ module Stripe
           end
         end
 
-        class Item < Stripe::RequestParams
-          class BillingThresholds < Stripe::RequestParams
-            # Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
+        class Item < ::Stripe::RequestParams
+          class BillingThresholds < ::Stripe::RequestParams
+            # Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
             attr_accessor :usage_gte
 
             def initialize(usage_gte: nil)
@@ -525,7 +551,7 @@ module Stripe
             end
           end
 
-          class Discount < Stripe::RequestParams
+          class Discount < ::Stripe::RequestParams
             # ID of the coupon to create a new discount for.
             attr_accessor :coupon
             # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -540,8 +566,8 @@ module Stripe
             end
           end
 
-          class PriceData < Stripe::RequestParams
-            class Recurring < Stripe::RequestParams
+          class PriceData < ::Stripe::RequestParams
+            class Recurring < ::Stripe::RequestParams
               # Specifies billing frequency. Either `day`, `week`, `month` or `year`.
               attr_accessor :interval
               # The number of intervals between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
@@ -558,7 +584,7 @@ module Stripe
             attr_accessor :product
             # The recurring components of a price such as `interval` and `interval_count`.
             attr_accessor :recurring
-            # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+            # Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
             attr_accessor :tax_behavior
             # A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
             attr_accessor :unit_amount
@@ -580,22 +606,26 @@ module Stripe
               @unit_amount = unit_amount
               @unit_amount_decimal = unit_amount_decimal
             end
+
+            def self.field_encodings
+              @field_encodings = { unit_amount_decimal: :decimal_string }
+            end
           end
           # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
           attr_accessor :billing_thresholds
           # The coupons to redeem into discounts for the subscription item.
           attr_accessor :discounts
-          # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`.
+          # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a configuration item. Metadata on a configuration item will update the underlying subscription item's `metadata` when the phase is entered, adding new keys and replacing existing keys. Individual keys in the subscription item's `metadata` can be unset by posting an empty value to them in the configuration item's `metadata`. To unset all keys in the subscription item's `metadata`, update the subscription item directly or unset every key individually from the configuration item's `metadata`.
           attr_accessor :metadata
           # The plan ID to subscribe to. You may specify the same ID in `plan` and `price`.
           attr_accessor :plan
           # The ID of the price object.
           attr_accessor :price
-          # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline.
+          # Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline.
           attr_accessor :price_data
           # Quantity for the given price. Can be set only if the price's `usage_type` is `licensed` and not `metered`.
           attr_accessor :quantity
-          # A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
+          # A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
           attr_accessor :tax_rates
 
           def initialize(
@@ -617,9 +647,15 @@ module Stripe
             @quantity = quantity
             @tax_rates = tax_rates
           end
+
+          def self.field_encodings
+            @field_encodings = {
+              price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+            }
+          end
         end
 
-        class TransferData < Stripe::RequestParams
+        class TransferData < ::Stripe::RequestParams
           # 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_accessor :amount_percent
           # ID of an existing, connected Stripe account.
@@ -636,7 +672,7 @@ module Stripe
         attr_accessor :application_fee_percent
         # Automatic tax settings for this phase.
         attr_accessor :automatic_tax
-        # Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://stripe.com/docs/billing/subscriptions/billing-cycle).
+        # Can be set to `phase_start` to set the anchor to the start of the phase or `automatic` to automatically change it if needed. Cannot be set to `phase_start` if this phase specifies a trial. For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
         attr_accessor :billing_cycle_anchor
         # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
         attr_accessor :billing_thresholds
@@ -646,7 +682,7 @@ module Stripe
         attr_accessor :currency
         # ID of the default payment method for the subscription schedule. It must belong to the customer associated with the subscription schedule. If not set, invoices will use the default payment method in the customer's invoice settings.
         attr_accessor :default_payment_method
-        # A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://stripe.com/docs/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase.
+        # A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will set the Subscription's [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates), which means they will be the Invoice's [`default_tax_rates`](https://docs.stripe.com/api/invoices/create#create_invoice-default_tax_rates) for any Invoices issued by the Subscription during this Phase.
         attr_accessor :default_tax_rates
         # Subscription description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription for rendering in Stripe surfaces and certain local payment methods UIs.
         attr_accessor :description
@@ -654,17 +690,17 @@ module Stripe
         attr_accessor :discounts
         # The number of intervals the phase should last. If set, `end_date` must not be set.
         attr_accessor :duration
-        # The date at which this phase of the subscription schedule ends. If set, `iterations` must not be set.
+        # The date at which this phase of the subscription schedule ends. If set, `duration` must not be set.
         attr_accessor :end_date
         # All invoices will be billed using the specified settings.
         attr_accessor :invoice_settings
         # List of configuration items, each with an attached price, to apply during this phase of the subscription schedule.
         attr_accessor :items
-        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`.
+        # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to a phase. Metadata on a schedule's phase will update the underlying subscription's `metadata` when the phase is entered, adding new keys and replacing existing keys in the subscription's `metadata`. Individual keys in the subscription's `metadata` can be unset by posting an empty value to them in the phase's `metadata`. To unset all keys in the subscription's `metadata`, update the subscription directly or unset every key individually from the phase's `metadata`.
         attr_accessor :metadata
         # The account on behalf of which to charge, for each of the associated subscription's invoices.
         attr_accessor :on_behalf_of
-        # Controls whether the subscription schedule should create [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://stripe.com/docs/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase.
+        # Controls whether the subscription schedule should create [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when transitioning to this phase if there is a difference in billing configuration. It's different from the request-level [proration_behavior](https://docs.stripe.com/api/subscription_schedules/update#update_subscription_schedule-proration_behavior) parameter which controls what happens if the update request affects the billing configuration (item price, quantity, etc.) of the current phase.
         attr_accessor :proration_behavior
         # The date at which this phase of the subscription schedule starts or `now`. Must be set on the first phase.
         attr_accessor :start_date
@@ -722,6 +758,29 @@ module Stripe
           @trial = trial
           @trial_end = trial_end
         end
+
+        def self.field_encodings
+          @field_encodings = {
+            add_invoice_items: {
+              kind: :array,
+              element: {
+                kind: :object,
+                fields: {
+                  price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                },
+              },
+            },
+            items: {
+              kind: :array,
+              element: {
+                kind: :object,
+                fields: {
+                  price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                },
+              },
+            },
+          }
+        end
       end
       # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
       attr_accessor :billing_mode
@@ -738,11 +797,42 @@ module Stripe
         @phases = phases
         @proration_behavior = proration_behavior
       end
+
+      def self.field_encodings
+        @field_encodings = {
+          phases: {
+            kind: :array,
+            element: {
+              kind: :object,
+              fields: {
+                add_invoice_items: {
+                  kind: :array,
+                  element: {
+                    kind: :object,
+                    fields: {
+                      price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                    },
+                  },
+                },
+                items: {
+                  kind: :array,
+                  element: {
+                    kind: :object,
+                    fields: {
+                      price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        }
+      end
     end
 
-    class SubscriptionDetails < Stripe::RequestParams
-      class BillingMode < Stripe::RequestParams
-        class Flexible < Stripe::RequestParams
+    class SubscriptionDetails < ::Stripe::RequestParams
+      class BillingMode < ::Stripe::RequestParams
+        class Flexible < ::Stripe::RequestParams
           # Controls how invoices and invoice items display proration amounts and discount amounts.
           attr_accessor :proration_discounts
 
@@ -761,9 +851,9 @@ module Stripe
         end
       end
 
-      class Item < Stripe::RequestParams
-        class BillingThresholds < Stripe::RequestParams
-          # Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
+      class Item < ::Stripe::RequestParams
+        class BillingThresholds < ::Stripe::RequestParams
+          # Number of units that meets the billing threshold to advance the subscription to a new billing period (e.g., it takes 10 $5 units to meet a $50 [monetary threshold](https://docs.stripe.com/api/subscriptions/update#update_subscription-billing_thresholds-amount_gte))
           attr_accessor :usage_gte
 
           def initialize(usage_gte: nil)
@@ -771,7 +861,7 @@ module Stripe
           end
         end
 
-        class Discount < Stripe::RequestParams
+        class Discount < ::Stripe::RequestParams
           # ID of the coupon to create a new discount for.
           attr_accessor :coupon
           # ID of an existing discount on the object (or one of its ancestors) to reuse.
@@ -786,8 +876,8 @@ module Stripe
           end
         end
 
-        class PriceData < Stripe::RequestParams
-          class Recurring < Stripe::RequestParams
+        class PriceData < ::Stripe::RequestParams
+          class Recurring < ::Stripe::RequestParams
             # Specifies billing frequency. Either `day`, `week`, `month` or `year`.
             attr_accessor :interval
             # The number of intervals between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
@@ -804,7 +894,7 @@ module Stripe
           attr_accessor :product
           # The recurring components of a price such as `interval` and `interval_count`.
           attr_accessor :recurring
-          # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+          # Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
           attr_accessor :tax_behavior
           # A positive integer in cents (or local equivalent) (or 0 for a free price) representing how much to charge.
           attr_accessor :unit_amount
@@ -826,6 +916,10 @@ module Stripe
             @unit_amount = unit_amount
             @unit_amount_decimal = unit_amount_decimal
           end
+
+          def self.field_encodings
+            @field_encodings = { unit_amount_decimal: :decimal_string }
+          end
         end
         # Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.
         attr_accessor :billing_thresholds
@@ -837,17 +931,17 @@ module Stripe
         attr_accessor :discounts
         # Subscription item to update.
         attr_accessor :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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+        # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
         attr_accessor :metadata
         # Plan ID for this item, as a string.
         attr_accessor :plan
         # The ID of the price object. One of `price` or `price_data` is required. When changing a subscription item's price, `quantity` is set to 1 unless a `quantity` parameter is provided.
         attr_accessor :price
-        # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
+        # Data used to generate a new [Price](https://docs.stripe.com/api/prices) object inline. One of `price` or `price_data` is required.
         attr_accessor :price_data
         # Quantity for this item.
         attr_accessor :quantity
-        # A list of [Tax Rate](https://stripe.com/docs/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://stripe.com/docs/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
+        # A list of [Tax Rate](https://docs.stripe.com/api/tax_rates) ids. These Tax Rates will override the [`default_tax_rates`](https://docs.stripe.com/api/subscriptions/create#create_subscription-default_tax_rates) on the Subscription. When updating, pass an empty string to remove previously-defined tax rates.
         attr_accessor :tax_rates
 
         def initialize(
@@ -875,8 +969,14 @@ module Stripe
           @quantity = quantity
           @tax_rates = tax_rates
         end
+
+        def self.field_encodings
+          @field_encodings = {
+            price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+          }
+        end
       end
-      # For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://stripe.com/docs/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`.
+      # For new subscriptions, a future timestamp to anchor the subscription's [billing cycle](https://docs.stripe.com/subscriptions/billing-cycle). This is used to determine the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to `now` or `unchanged`.
       attr_accessor :billing_cycle_anchor
       # Controls how prorations and invoices for subscriptions are calculated and orchestrated.
       attr_accessor :billing_mode
@@ -890,7 +990,7 @@ module Stripe
       attr_accessor :default_tax_rates
       # A list of up to 20 subscription items, each with an attached price.
       attr_accessor :items
-      # Determines how to handle [prorations](https://stripe.com/docs/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`.
+      # Determines how to handle [prorations](https://docs.stripe.com/billing/subscriptions/prorations) when the billing cycle changes (e.g., when switching plans, resetting `billing_cycle_anchor=now`, or starting a trial), or if an item's `quantity` changes. The default value is `create_prorations`.
       attr_accessor :proration_behavior
       # If previewing an update to a subscription, and doing proration, `subscription_details.proration_date` forces the proration to be calculated as though the update was done at the specified time. The time given must be within the current subscription period and within the current phase of the schedule backing this subscription, if the schedule exists. If set, `subscription`, and one of `subscription_details.items`, or `subscription_details.trial_end` are required. Also, `subscription_details.proration_behavior` cannot be set to 'none'.
       attr_accessor :proration_date
@@ -928,13 +1028,27 @@ module Stripe
         @start_date = start_date
         @trial_end = trial_end
       end
+
+      def self.field_encodings
+        @field_encodings = {
+          items: {
+            kind: :array,
+            element: {
+              kind: :object,
+              fields: { price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } } },
+            },
+          },
+        }
+      end
     end
     # Settings for automatic tax lookup for this invoice preview.
     attr_accessor :automatic_tax
     # The currency to preview this invoice in. Defaults to that of `customer` if not specified.
     attr_accessor :currency
-    # The identifier of the customer whose upcoming invoice you'd like to retrieve. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set.
+    # The identifier of the customer whose upcoming invoice you're retrieving. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set.
     attr_accessor :customer
+    # The identifier of the account representing the customer whose upcoming invoice you're retrieving. If `automatic_tax` is enabled then one of `customer`, `customer_account`, `customer_details`, `subscription`, or `schedule` must be set.
+    attr_accessor :customer_account
     # Details about the customer you want to invoice or overrides for an existing customer. If `automatic_tax` is enabled then one of `customer`, `customer_details`, `subscription`, or `schedule` must be set.
     attr_accessor :customer_details
     # The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the subscription or customer. This works for both coupons directly applied to an invoice and coupons applied to a subscription. Pass an empty string to avoid inheriting any discounts.
@@ -945,7 +1059,7 @@ module Stripe
     attr_accessor :invoice_items
     # The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
     attr_accessor :issuer
-    # The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the [Invoices with Connect](https://stripe.com/docs/billing/invoices/connect) documentation for details.
+    # The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the [Invoices with Connect](https://docs.stripe.com/billing/invoices/connect) documentation for details.
     attr_accessor :on_behalf_of
     # Customizes the types of values to include when calculating the invoice. Defaults to `next` if unspecified.
     attr_accessor :preview_mode
@@ -962,6 +1076,7 @@ module Stripe
       automatic_tax: nil,
       currency: nil,
       customer: nil,
+      customer_account: nil,
       customer_details: nil,
       discounts: nil,
       expand: nil,
@@ -977,6 +1092,7 @@ module Stripe
       @automatic_tax = automatic_tax
       @currency = currency
       @customer = customer
+      @customer_account = customer_account
       @customer_details = customer_details
       @discounts = discounts
       @expand = expand
@@ -989,5 +1105,66 @@ module Stripe
       @subscription = subscription
       @subscription_details = subscription_details
     end
+
+    def self.field_encodings
+      @field_encodings = {
+        invoice_items: {
+          kind: :array,
+          element: {
+            kind: :object,
+            fields: {
+              price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+              quantity_decimal: :decimal_string,
+              unit_amount_decimal: :decimal_string,
+            },
+          },
+        },
+        schedule_details: {
+          kind: :object,
+          fields: {
+            phases: {
+              kind: :array,
+              element: {
+                kind: :object,
+                fields: {
+                  add_invoice_items: {
+                    kind: :array,
+                    element: {
+                      kind: :object,
+                      fields: {
+                        price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                      },
+                    },
+                  },
+                  items: {
+                    kind: :array,
+                    element: {
+                      kind: :object,
+                      fields: {
+                        price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+        subscription_details: {
+          kind: :object,
+          fields: {
+            items: {
+              kind: :array,
+              element: {
+                kind: :object,
+                fields: {
+                  price_data: { kind: :object, fields: { unit_amount_decimal: :decimal_string } },
+                },
+              },
+            },
+          },
+        },
+      }
+    end
   end
 end