stripe 17.0.1 → 19.0.0

data/lib/stripe/params/billing/meter_update_params.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module Billing
-    class MeterUpdateParams < Stripe::RequestParams
+    class MeterUpdateParams < ::Stripe::RequestParams
       # The meter’s name. Not visible to the customer.
       attr_accessor :display_name
       # Specifies which fields in the response should be expanded.

data/lib/stripe/params/billing_portal/configuration_create_params.rb

@@ -3,8 +3,8 @@
 
 module Stripe
   module BillingPortal
-    class ConfigurationCreateParams < Stripe::RequestParams
-      class BusinessProfile < Stripe::RequestParams
+    class ConfigurationCreateParams < ::Stripe::RequestParams
+      class BusinessProfile < ::Stripe::RequestParams
         # The messaging shown to customers in the portal.
         attr_accessor :headline
         # A link to the business’s publicly available privacy policy.
@@ -19,8 +19,8 @@ module Stripe
         end
       end
 
-      class Features < Stripe::RequestParams
-        class CustomerUpdate < Stripe::RequestParams
+      class Features < ::Stripe::RequestParams
+        class CustomerUpdate < ::Stripe::RequestParams
           # The types of customer updates that are supported. When empty, customers are not updateable.
           attr_accessor :allowed_updates
           # Whether the feature is enabled.
@@ -32,7 +32,7 @@ module Stripe
           end
         end
 
-        class InvoiceHistory < Stripe::RequestParams
+        class InvoiceHistory < ::Stripe::RequestParams
           # Whether the feature is enabled.
           attr_accessor :enabled
 
@@ -41,17 +41,20 @@ module Stripe
           end
         end
 
-        class PaymentMethodUpdate < Stripe::RequestParams
+        class PaymentMethodUpdate < ::Stripe::RequestParams
           # Whether the feature is enabled.
           attr_accessor :enabled
+          # The [Payment Method Configuration](/api/payment_method_configurations) to use for this portal session. When specified, customers will be able to update their payment method to one of the options specified by the payment method configuration. If not set or set to an empty string, the default payment method configuration is used.
+          attr_accessor :payment_method_configuration
 
-          def initialize(enabled: nil)
+          def initialize(enabled: nil, payment_method_configuration: nil)
             @enabled = enabled
+            @payment_method_configuration = payment_method_configuration
           end
         end
 
-        class SubscriptionCancel < Stripe::RequestParams
-          class CancellationReason < Stripe::RequestParams
+        class SubscriptionCancel < ::Stripe::RequestParams
+          class CancellationReason < ::Stripe::RequestParams
             # Whether the feature is enabled.
             attr_accessor :enabled
             # Which cancellation reasons will be given as options to the customer.
@@ -79,9 +82,9 @@ module Stripe
           end
         end
 
-        class SubscriptionUpdate < Stripe::RequestParams
-          class Product < Stripe::RequestParams
-            class AdjustableQuantity < Stripe::RequestParams
+        class SubscriptionUpdate < ::Stripe::RequestParams
+          class Product < ::Stripe::RequestParams
+            class AdjustableQuantity < ::Stripe::RequestParams
               # Set to true if the quantity can be adjusted to any non-negative integer.
               attr_accessor :enabled
               # The maximum quantity that can be set for the product.
@@ -109,8 +112,8 @@ module Stripe
             end
           end
 
-          class ScheduleAtPeriodEnd < Stripe::RequestParams
-            class Condition < Stripe::RequestParams
+          class ScheduleAtPeriodEnd < ::Stripe::RequestParams
+            class Condition < ::Stripe::RequestParams
               # The type of condition.
               attr_accessor :type
 
@@ -125,6 +128,8 @@ module Stripe
               @conditions = conditions
             end
           end
+          # Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
+          attr_accessor :billing_cycle_anchor
           # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
           attr_accessor :default_allowed_updates
           # Whether the feature is enabled.
@@ -139,6 +144,7 @@ module Stripe
           attr_accessor :trial_update_behavior
 
           def initialize(
+            billing_cycle_anchor: nil,
             default_allowed_updates: nil,
             enabled: nil,
             products: nil,
@@ -146,6 +152,7 @@ module Stripe
             schedule_at_period_end: nil,
             trial_update_behavior: nil
           )
+            @billing_cycle_anchor = billing_cycle_anchor
             @default_allowed_updates = default_allowed_updates
             @enabled = enabled
             @products = products
@@ -180,8 +187,8 @@ module Stripe
         end
       end
 
-      class LoginPage < Stripe::RequestParams
-        # Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
+      class LoginPage < ::Stripe::RequestParams
+        # Set to `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
         attr_accessor :enabled
 
         def initialize(enabled: nil)
@@ -190,7 +197,7 @@ module Stripe
       end
       # The business information shown to customers in the portal.
       attr_accessor :business_profile
-      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
+      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
       attr_accessor :default_return_url
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
@@ -198,7 +205,7 @@ module Stripe
       attr_accessor :features
       # The hosted login page for this configuration. Learn more about the portal login page in our [integration docs](https://stripe.com/docs/billing/subscriptions/integrating-customer-portal#share).
       attr_accessor :login_page
-      # 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 name of the configuration.
       attr_accessor :name

data/lib/stripe/params/billing_portal/configuration_list_params.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module BillingPortal
-    class ConfigurationListParams < Stripe::RequestParams
+    class ConfigurationListParams < ::Stripe::RequestParams
       # Only return configurations that are active or inactive (e.g., pass `true` to only list active configurations).
       attr_accessor :active
       # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.

data/lib/stripe/params/billing_portal/configuration_retrieve_params.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module BillingPortal
-    class ConfigurationRetrieveParams < Stripe::RequestParams
+    class ConfigurationRetrieveParams < ::Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
 

data/lib/stripe/params/billing_portal/configuration_update_params.rb

@@ -3,8 +3,8 @@
 
 module Stripe
   module BillingPortal
-    class ConfigurationUpdateParams < Stripe::RequestParams
-      class BusinessProfile < Stripe::RequestParams
+    class ConfigurationUpdateParams < ::Stripe::RequestParams
+      class BusinessProfile < ::Stripe::RequestParams
         # The messaging shown to customers in the portal.
         attr_accessor :headline
         # A link to the business’s publicly available privacy policy.
@@ -19,8 +19,8 @@ module Stripe
         end
       end
 
-      class Features < Stripe::RequestParams
-        class CustomerUpdate < Stripe::RequestParams
+      class Features < ::Stripe::RequestParams
+        class CustomerUpdate < ::Stripe::RequestParams
           # The types of customer updates that are supported. When empty, customers are not updateable.
           attr_accessor :allowed_updates
           # Whether the feature is enabled.
@@ -32,7 +32,7 @@ module Stripe
           end
         end
 
-        class InvoiceHistory < Stripe::RequestParams
+        class InvoiceHistory < ::Stripe::RequestParams
           # Whether the feature is enabled.
           attr_accessor :enabled
 
@@ -41,17 +41,20 @@ module Stripe
           end
         end
 
-        class PaymentMethodUpdate < Stripe::RequestParams
+        class PaymentMethodUpdate < ::Stripe::RequestParams
           # Whether the feature is enabled.
           attr_accessor :enabled
+          # The [Payment Method Configuration](/api/payment_method_configurations) to use for this portal session. When specified, customers will be able to update their payment method to one of the options specified by the payment method configuration. If not set or set to an empty string, the default payment method configuration is used.
+          attr_accessor :payment_method_configuration
 
-          def initialize(enabled: nil)
+          def initialize(enabled: nil, payment_method_configuration: nil)
             @enabled = enabled
+            @payment_method_configuration = payment_method_configuration
           end
         end
 
-        class SubscriptionCancel < Stripe::RequestParams
-          class CancellationReason < Stripe::RequestParams
+        class SubscriptionCancel < ::Stripe::RequestParams
+          class CancellationReason < ::Stripe::RequestParams
             # Whether the feature is enabled.
             attr_accessor :enabled
             # Which cancellation reasons will be given as options to the customer.
@@ -79,9 +82,9 @@ module Stripe
           end
         end
 
-        class SubscriptionUpdate < Stripe::RequestParams
-          class Product < Stripe::RequestParams
-            class AdjustableQuantity < Stripe::RequestParams
+        class SubscriptionUpdate < ::Stripe::RequestParams
+          class Product < ::Stripe::RequestParams
+            class AdjustableQuantity < ::Stripe::RequestParams
               # Set to true if the quantity can be adjusted to any non-negative integer.
               attr_accessor :enabled
               # The maximum quantity that can be set for the product.
@@ -109,8 +112,8 @@ module Stripe
             end
           end
 
-          class ScheduleAtPeriodEnd < Stripe::RequestParams
-            class Condition < Stripe::RequestParams
+          class ScheduleAtPeriodEnd < ::Stripe::RequestParams
+            class Condition < ::Stripe::RequestParams
               # The type of condition.
               attr_accessor :type
 
@@ -125,6 +128,8 @@ module Stripe
               @conditions = conditions
             end
           end
+          # Determines the value to use for the billing cycle anchor on subscription updates. Valid values are `now` or `unchanged`, and the default value is `unchanged`. Setting the value to `now` resets the subscription's billing cycle anchor to the current time (in UTC). For more information, see the billing cycle [documentation](https://docs.stripe.com/billing/subscriptions/billing-cycle).
+          attr_accessor :billing_cycle_anchor
           # The types of subscription updates that are supported. When empty, subscriptions are not updateable.
           attr_accessor :default_allowed_updates
           # Whether the feature is enabled.
@@ -139,6 +144,7 @@ module Stripe
           attr_accessor :trial_update_behavior
 
           def initialize(
+            billing_cycle_anchor: nil,
             default_allowed_updates: nil,
             enabled: nil,
             products: nil,
@@ -146,6 +152,7 @@ module Stripe
             schedule_at_period_end: nil,
             trial_update_behavior: nil
           )
+            @billing_cycle_anchor = billing_cycle_anchor
             @default_allowed_updates = default_allowed_updates
             @enabled = enabled
             @products = products
@@ -180,8 +187,8 @@ module Stripe
         end
       end
 
-      class LoginPage < Stripe::RequestParams
-        # Set to `true` to generate a shareable URL [`login_page.url`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
+      class LoginPage < ::Stripe::RequestParams
+        # Set to `true` to generate a shareable URL [`login_page.url`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-login_page-url) that will take your customers to a hosted login page for the customer portal.
         #
         # Set to `false` to deactivate the `login_page.url`.
         attr_accessor :enabled
@@ -194,7 +201,7 @@ module Stripe
       attr_accessor :active
       # The business information shown to customers in the portal.
       attr_accessor :business_profile
-      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
+      # The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
       attr_accessor :default_return_url
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
@@ -202,7 +209,7 @@ module Stripe
       attr_accessor :features
       # The hosted login page for this configuration. Learn more about the portal login page in our [integration docs](https://stripe.com/docs/billing/subscriptions/integrating-customer-portal#share).
       attr_accessor :login_page
-      # 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 name of the configuration.
       attr_accessor :name

data/lib/stripe/params/billing_portal/session_create_params.rb

@@ -3,10 +3,10 @@
 
 module Stripe
   module BillingPortal
-    class SessionCreateParams < Stripe::RequestParams
-      class FlowData < Stripe::RequestParams
-        class AfterCompletion < Stripe::RequestParams
-          class HostedConfirmation < Stripe::RequestParams
+    class SessionCreateParams < ::Stripe::RequestParams
+      class FlowData < ::Stripe::RequestParams
+        class AfterCompletion < ::Stripe::RequestParams
+          class HostedConfirmation < ::Stripe::RequestParams
             # A custom message to display to the customer after the flow is completed.
             attr_accessor :custom_message
 
@@ -15,7 +15,7 @@ module Stripe
             end
           end
 
-          class Redirect < Stripe::RequestParams
+          class Redirect < ::Stripe::RequestParams
             # The URL the customer will be redirected to after the flow is completed.
             attr_accessor :return_url
 
@@ -37,9 +37,9 @@ module Stripe
           end
         end
 
-        class SubscriptionCancel < Stripe::RequestParams
-          class Retention < Stripe::RequestParams
-            class CouponOffer < Stripe::RequestParams
+        class SubscriptionCancel < ::Stripe::RequestParams
+          class Retention < ::Stripe::RequestParams
+            class CouponOffer < ::Stripe::RequestParams
               # The ID of the coupon to be offered.
               attr_accessor :coupon
 
@@ -68,7 +68,7 @@ module Stripe
           end
         end
 
-        class SubscriptionUpdate < Stripe::RequestParams
+        class SubscriptionUpdate < ::Stripe::RequestParams
           # The ID of the subscription to be updated.
           attr_accessor :subscription
 
@@ -77,8 +77,8 @@ module Stripe
           end
         end
 
-        class SubscriptionUpdateConfirm < Stripe::RequestParams
-          class Discount < Stripe::RequestParams
+        class SubscriptionUpdateConfirm < ::Stripe::RequestParams
+          class Discount < ::Stripe::RequestParams
             # The ID of the coupon to apply to this subscription update.
             attr_accessor :coupon
             # The ID of a promotion code to apply to this subscription update.
@@ -90,12 +90,12 @@ module Stripe
             end
           end
 
-          class Item < Stripe::RequestParams
-            # The ID of the [subscription item](https://stripe.com/docs/api/subscriptions/object#subscription_object-items-data-id) to be updated.
+          class Item < ::Stripe::RequestParams
+            # The ID of the [subscription item](https://docs.stripe.com/api/subscriptions/object#subscription_object-items-data-id) to be updated.
             attr_accessor :id
-            # The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://stripe.com/docs/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products).
+            # The price the customer should subscribe to through this flow. The price must also be included in the configuration's [`features.subscription_update.products`](https://docs.stripe.com/api/customer_portal/configuration#portal_configuration_object-features-subscription_update-products).
             attr_accessor :price
-            # [Quantity](https://stripe.com/docs/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
+            # [Quantity](https://docs.stripe.com/subscriptions/quantities) for this item that the customer should subscribe to through this flow.
             attr_accessor :quantity
 
             def initialize(id: nil, price: nil, quantity: nil)
@@ -106,7 +106,7 @@ module Stripe
           end
           # The coupon or promotion code to apply to this subscription update.
           attr_accessor :discounts
-          # The [subscription item](https://stripe.com/docs/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
+          # The [subscription item](https://docs.stripe.com/api/subscription_items) to be updated through this flow. Currently, only up to one may be specified and subscriptions with multiple items are not updatable.
           attr_accessor :items
           # The ID of the subscription to be updated.
           attr_accessor :subscription
@@ -142,17 +142,19 @@ module Stripe
           @type = type
         end
       end
-      # The ID of an existing [configuration](https://stripe.com/docs/api/customer_portal/configuration) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
+      # The ID of an existing [configuration](https://docs.stripe.com/api/customer_portal/configurations) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration.
       attr_accessor :configuration
       # The ID of an existing customer.
       attr_accessor :customer
+      # The ID of an existing account.
+      attr_accessor :customer_account
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
-      # Information about a specific flow for the customer to go through. See the [docs](https://stripe.com/docs/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows.
+      # Information about a specific flow for the customer to go through. See the [docs](https://docs.stripe.com/customer-management/portal-deep-links) to learn more about using customer portal deep links and flows.
       attr_accessor :flow_data
       # The IETF language tag of the locale customer portal is displayed in. If blank or auto, the customer’s `preferred_locales` or browser’s locale is used.
       attr_accessor :locale
-      # The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://stripe.com/docs/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
+      # The `on_behalf_of` account to use for this session. When specified, only subscriptions and invoices with this `on_behalf_of` account appear in the portal. For more information, see the [docs](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant). Use the [Accounts API](https://docs.stripe.com/api/accounts/object#account_object-settings-branding) to modify the `on_behalf_of` account's branding settings, which the portal displays.
       attr_accessor :on_behalf_of
       # The default URL to redirect customers to when they click on the portal's link to return to your website.
       attr_accessor :return_url
@@ -160,6 +162,7 @@ module Stripe
       def initialize(
         configuration: nil,
         customer: nil,
+        customer_account: nil,
         expand: nil,
         flow_data: nil,
         locale: nil,
@@ -168,6 +171,7 @@ module Stripe
       )
         @configuration = configuration
         @customer = customer
+        @customer_account = customer_account
         @expand = expand
         @flow_data = flow_data
         @locale = locale

data/lib/stripe/params/charge_capture_params.rb

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeCaptureParams < Stripe::RequestParams
-    class TransferData < Stripe::RequestParams
+  class ChargeCaptureParams < ::Stripe::RequestParams
+    class TransferData < ::Stripe::RequestParams
       # The amount transferred to the destination account, if specified. By default, the entire charge amount is transferred to the destination account.
       attr_accessor :amount
 
@@ -27,9 +27,9 @@ module Stripe
     attr_accessor :statement_descriptor
     # Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement. If the account has no prefix value, the suffix is concatenated to the account's statement descriptor.
     attr_accessor :statement_descriptor_suffix
-    # An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://stripe.com/docs/connect/destination-charges) for details.
+    # An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://docs.stripe.com/connect/destination-charges) for details.
     attr_accessor :transfer_data
-    # A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details.
+    # A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details.
     attr_accessor :transfer_group
 
     def initialize(

data/lib/stripe/params/charge_create_params.rb

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeCreateParams < Stripe::RequestParams
-    class Destination < Stripe::RequestParams
+  class ChargeCreateParams < ::Stripe::RequestParams
+    class Destination < ::Stripe::RequestParams
       # ID of an existing, connected Stripe account.
       attr_accessor :account
       # The amount to transfer to the destination account without creating an `Application Fee` object. Cannot be combined with the `application_fee` parameter. Must be less than or equal to the charge amount.
@@ -15,8 +15,8 @@ module Stripe
       end
     end
 
-    class RadarOptions < Stripe::RequestParams
-      # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
+    class RadarOptions < ::Stripe::RequestParams
+      # A [Radar Session](https://docs.stripe.com/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
       attr_accessor :session
 
       def initialize(session: nil)
@@ -24,8 +24,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
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -36,7 +36,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(
@@ -75,7 +75,7 @@ module Stripe
       end
     end
 
-    class TransferData < Stripe::RequestParams
+    class TransferData < ::Stripe::RequestParams
       # The amount transferred to the destination account, if specified. By default, the entire charge amount is transferred to the destination account.
       attr_accessor :amount
       # ID of an existing, connected Stripe account.
@@ -86,13 +86,13 @@ module Stripe
         @destination = destination
       end
     end
-    # Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
+    # Amount intended to be collected by this payment. A positive integer representing how much to charge in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://docs.stripe.com/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
     attr_accessor :amount
     # Attribute for param field application_fee
     attr_accessor :application_fee
-    # A fee in cents (or local equivalent) that will be applied to the charge and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the `Stripe-Account` header in order to take an application fee. For more information, see the application fees [documentation](https://stripe.com/docs/connect/direct-charges#collect-fees).
+    # A fee in cents (or local equivalent) that will be applied to the charge and transferred to the application owner's Stripe account. The request must be made with an OAuth key or the `Stripe-Account` header in order to take an application fee. For more information, see the application fees [documentation](https://docs.stripe.com/connect/direct-charges#collect-fees).
     attr_accessor :application_fee_amount
-    # Whether to immediately capture the charge. Defaults to `true`. When `false`, the charge issues an authorization (or pre-authorization), and will need to be [captured](https://stripe.com/docs/api#capture_charge) later. Uncaptured charges expire after a set number of days (7 by default). For more information, see the [authorizing charges and settling later](https://stripe.com/docs/charges/placing-a-hold) documentation.
+    # Whether to immediately capture the charge. Defaults to `true`. When `false`, the charge issues an authorization (or pre-authorization), and will need to be [captured](https://api.stripe.com#capture_charge) later. Uncaptured charges expire after a set number of days (7 by default). For more information, see the [authorizing charges and settling later](https://docs.stripe.com/charges/placing-a-hold) documentation.
     attr_accessor :capture
     # 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
@@ -104,17 +104,17 @@ module Stripe
     attr_accessor :destination
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
-    # 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 Stripe account ID for which these funds are intended. Automatically set if you use the `destination` parameter. For details, see [Creating Separate Charges and Transfers](https://stripe.com/docs/connect/separate-charges-and-transfers#settlement-merchant).
+    # The Stripe account ID for which these funds are intended. You can specify the business of record as the connected account using the `on_behalf_of` attribute on the charge. For details, see [Creating Separate Charges and Transfers](https://docs.stripe.com/connect/separate-charges-and-transfers#settlement-merchant).
     attr_accessor :on_behalf_of
-    # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
+    # Options to configure Radar. See [Radar Session](https://docs.stripe.com/radar/radar-session) for more information.
     attr_accessor :radar_options
-    # The email address to which this charge's [receipt](https://stripe.com/docs/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and no receipts will be sent for test mode charges. If this charge is for a [Customer](https://stripe.com/docs/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
+    # The email address to which this charge's [receipt](https://docs.stripe.com/dashboard/receipts) will be sent. The receipt will not be sent until the charge is paid, and no receipts will be sent for test mode charges. If this charge is for a [Customer](https://docs.stripe.com/api/customers/object), the email address specified here will override the customer's email address. If `receipt_email` is specified for a charge in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
     attr_accessor :receipt_email
     # Shipping information for the charge. Helps prevent fraud on charges for physical goods.
     attr_accessor :shipping
-    # A payment source to be charged. This can be the ID of a [card](https://stripe.com/docs/api#cards) (i.e., credit or debit card), a [bank account](https://stripe.com/docs/api#bank_accounts), a [source](https://stripe.com/docs/api#sources), a [token](https://stripe.com/docs/api#tokens), or a [connected account](https://stripe.com/docs/connect/account-debits#charging-a-connected-account). For certain sources---namely, [cards](https://stripe.com/docs/api#cards), [bank accounts](https://stripe.com/docs/api#bank_accounts), and attached [sources](https://stripe.com/docs/api#sources)---you must also pass the ID of the associated customer.
+    # A payment source to be charged. This can be the ID of a [card](https://docs.stripe.com/api#cards) (i.e., credit or debit card), a [bank account](https://docs.stripe.com/api#bank_accounts), a [source](https://docs.stripe.com/api#sources), a [token](https://docs.stripe.com/api#tokens), or a [connected account](https://docs.stripe.com/connect/account-debits#charging-a-connected-account). For certain sources---namely, [cards](https://docs.stripe.com/api#cards), [bank accounts](https://docs.stripe.com/api#bank_accounts), and attached [sources](https://docs.stripe.com/api#sources)---you must also pass the ID of the associated customer.
     attr_accessor :source
     # For a non-card charge, text that appears on the customer's statement as the statement descriptor. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
     #
@@ -122,9 +122,9 @@ module Stripe
     attr_accessor :statement_descriptor
     # Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement. If the account has no prefix value, the suffix is concatenated to the account's statement descriptor.
     attr_accessor :statement_descriptor_suffix
-    # An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://stripe.com/docs/connect/destination-charges) for details.
+    # An optional dictionary including the account to automatically transfer to as part of a destination charge. [See the Connect documentation](https://docs.stripe.com/connect/destination-charges) for details.
     attr_accessor :transfer_data
-    # A string that identifies this transaction as part of a group. For details, see [Grouping transactions](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options).
+    # A string that identifies this transaction as part of a group. For details, see [Grouping transactions](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options).
     attr_accessor :transfer_group
 
     def initialize(

data/lib/stripe/params/charge_list_params.rb

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeListParams < Stripe::RequestParams
-    class Created < Stripe::RequestParams
+  class ChargeListParams < ::Stripe::RequestParams
+    class Created < ::Stripe::RequestParams
       # Minimum value to filter by (exclusive)
       attr_accessor :gt
       # Minimum value to filter by (inclusive)

data/lib/stripe/params/charge_retrieve_params.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeRetrieveParams < Stripe::RequestParams
+  class ChargeRetrieveParams < ::Stripe::RequestParams
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
 

data/lib/stripe/params/charge_search_params.rb

@@ -2,14 +2,14 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeSearchParams < Stripe::RequestParams
+  class ChargeSearchParams < ::Stripe::RequestParams
     # Specifies which fields in the response should be expanded.
     attr_accessor :expand
     # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
     attr_accessor :limit
     # A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
     attr_accessor :page
-    # The search query string. See [search query language](https://stripe.com/docs/search#search-query-language) and the list of supported [query fields for charges](https://stripe.com/docs/search#query-fields-for-charges).
+    # The search query string. See [search query language](https://docs.stripe.com/search#search-query-language) and the list of supported [query fields for charges](https://docs.stripe.com/search#query-fields-for-charges).
     attr_accessor :query
 
     def initialize(expand: nil, limit: nil, page: nil, query: nil)

data/lib/stripe/params/charge_update_params.rb

@@ -2,8 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
-  class ChargeUpdateParams < Stripe::RequestParams
-    class FraudDetails < Stripe::RequestParams
+  class ChargeUpdateParams < ::Stripe::RequestParams
+    class FraudDetails < ::Stripe::RequestParams
       # Either `safe` or `fraudulent`.
       attr_accessor :user_report
 
@@ -12,8 +12,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
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -24,7 +24,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(
@@ -70,13 +70,13 @@ module Stripe
     attr_accessor :expand
     # A set of key-value pairs you can attach to a charge giving information about its riskiness. If you believe a charge is fraudulent, include a `user_report` key with a value of `fraudulent`. If you believe a charge is safe, include a `user_report` key with a value of `safe`. Stripe will use the information you send to improve our fraud detection algorithms.
     attr_accessor :fraud_details
-    # 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
     # This is the email address that the receipt for this charge will be sent to. If this field is updated, then a new email receipt will be sent to the updated address.
     attr_accessor :receipt_email
     # Shipping information for the charge. Helps prevent fraud on charges for physical goods.
     attr_accessor :shipping
-    # A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details.
+    # A string that identifies this transaction as part of a group. `transfer_group` may only be provided if it has not been set. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details.
     attr_accessor :transfer_group
 
     def initialize(