Merge upstream and update generated code for v1565

Author: stripe-openapi[bot]

OPENAPI_VERSION

@@ -1 +1 @@
-v1472
+v1565

lib/stripe/api_version.rb

@@ -3,6 +3,6 @@
 
 module Stripe
   module ApiVersion
-    CURRENT = "2025-01-27.acacia"
+    CURRENT = "2025-03-31.basil"
   end
 end

lib/stripe/resources/account.rb

@@ -561,6 +561,8 @@ class Dashboard < Stripe::StripeObject
       class Invoices < Stripe::StripeObject
         # The list of default Account Tax IDs to automatically include on invoices. Account Tax IDs get added when an invoice is finalized.
         attr_reader :default_account_tax_ids
+        # Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+        attr_reader :hosted_payment_method_save
       end
 
       class Payments < Stripe::StripeObject
@@ -2581,9 +2583,12 @@ def initialize(
         class Invoices < Stripe::RequestParams
           # The list of default Account Tax IDs to automatically include on invoices. Account Tax IDs get added when an invoice is finalized.
           attr_accessor :default_account_tax_ids
+          # Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+          attr_accessor :hosted_payment_method_save
 
-          def initialize(default_account_tax_ids: nil)
+          def initialize(default_account_tax_ids: nil, hosted_payment_method_save: nil)
             @default_account_tax_ids = default_account_tax_ids
+            @hosted_payment_method_save = hosted_payment_method_save
           end
         end
 
@@ -4842,6 +4847,15 @@ def initialize(
           end
         end
 
+        class Invoices < Stripe::RequestParams
+          # Whether payment methods should be saved when a payment is completed for a one-time invoices on a hosted invoice page.
+          attr_accessor :hosted_payment_method_save
+
+          def initialize(hosted_payment_method_save: nil)
+            @hosted_payment_method_save = hosted_payment_method_save
+          end
+        end
+
         class Payments < Stripe::RequestParams
           # The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
           attr_accessor :statement_descriptor
@@ -4936,6 +4950,8 @@ def initialize(tos_acceptance: nil)
         attr_accessor :card_issuing
         # Settings specific to card charging on the account.
         attr_accessor :card_payments
+        # Settings specific to the account’s use of Invoices.
+        attr_accessor :invoices
         # Settings that apply across payment methods for charging on the account.
         attr_accessor :payments
         # Settings specific to the account's payouts.
@@ -4952,6 +4968,7 @@ def initialize(
           capital: nil,
           card_issuing: nil,
           card_payments: nil,
+          invoices: nil,
           payments: nil,
           payouts: nil,
           tax_forms: nil,
@@ -4963,6 +4980,7 @@ def initialize(
           @capital = capital
           @card_issuing = card_issuing
           @card_payments = card_payments
+          @invoices = invoices
           @payments = payments
           @payouts = payouts
           @tax_forms = tax_forms

lib/stripe/resources/application_fee.rb

@@ -18,7 +18,7 @@ class FeeSource < Stripe::StripeObject
       attr_reader :charge
       # Payout ID that created this application fee.
       attr_reader :payout
-      # Type of object that created the application fee, either `charge` or `payout`.
+      # Type of object that created the application fee.
       attr_reader :type
     end
 

lib/stripe/resources/bank_account.rb

@@ -56,7 +56,7 @@ class Error < Stripe::StripeObject
       # Fields that might become required depending on the results of verification or review. It's an empty array unless an asynchronous verification is pending. If verification fails, these fields move to `eventually_due`, `currently_due`, or `past_due`. Fields might appear in `eventually_due`, `currently_due`, or `past_due` and in `pending_verification` if verification fails but another verification is still pending.
       attr_reader :pending_verification
     end
-    # The ID of the account that the bank account is associated with.
+    # The account this bank account belongs to. Only applicable on Accounts (not customers or recipients) This property is only available when returned as an [External Account](/api/external_account_bank_accounts/object) where [controller.is_controller](/api/accounts/object#account_object-controller-is_controller) is `true`.
     attr_reader :account
     # The name of the person or business that owns the bank account.
     attr_reader :account_holder_name

lib/stripe/resources/billing/credit_balance_summary.rb

@@ -53,9 +53,9 @@ def initialize(id: nil)
                 @id = id
               end
             end
-            # The price type that credit grants can apply to. We currently only support the `metered` price type.
+            # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
             attr_accessor :price_type
-            # A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+            # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
             attr_accessor :prices
 
             def initialize(price_type: nil, prices: nil)

lib/stripe/resources/billing/credit_grant.rb

@@ -35,9 +35,9 @@ class Price < Stripe::StripeObject
             # Unique identifier for the object.
             attr_reader :id
           end
-          # The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+          # The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them. Cannot be used in combination with `prices`.
           attr_reader :price_type
-          # The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+          # The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them. Cannot be used in combination with `price_type`.
           attr_reader :prices
         end
         # Attribute for field scope
@@ -105,9 +105,9 @@ def initialize(id: nil)
                 @id = id
               end
             end
-            # The price type that credit grants can apply to. We currently only support the `metered` price type.
+            # The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
             attr_accessor :price_type
-            # A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+            # A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
             attr_accessor :prices
 
             def initialize(price_type: nil, prices: nil)
@@ -124,7 +124,7 @@ def initialize(scope: nil)
         end
         # Amount of this credit grant.
         attr_accessor :amount
-        # Configuration specifying what this credit grant applies to.
+        # Configuration specifying what this credit grant applies to. We currently only support `metered` prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
         attr_accessor :applicability_config
         # The category of this credit grant.
         attr_accessor :category
@@ -140,6 +140,8 @@ def initialize(scope: nil)
         attr_accessor :metadata
         # A descriptive name shown in the Dashboard.
         attr_accessor :name
+        # The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+        attr_accessor :priority
 
         def initialize(
           amount: nil,
@@ -150,7 +152,8 @@ def initialize(
           expand: nil,
           expires_at: nil,
           metadata: nil,
-          name: nil
+          name: nil,
+          priority: nil
         )
           @amount = amount
           @applicability_config = applicability_config
@@ -161,6 +164,7 @@ def initialize(
           @expires_at = expires_at
           @metadata = metadata
           @name = name
+          @priority = priority
         end
       end
 
@@ -229,6 +233,8 @@ def initialize(expand: nil)
       attr_reader :name
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
+      # The priority for applying this credit grant. The highest priority is 0 and the lowest is 100.
+      attr_reader :priority
       # ID of the test clock this credit grant belongs to.
       attr_reader :test_clock
       # Time at which the object was last updated. Measured in seconds since the Unix epoch.

lib/stripe/resources/card.rb

@@ -21,7 +21,7 @@ class Networks < Stripe::StripeObject
       # The preferred network for co-branded cards. Can be `cartes_bancaires`, `mastercard`, `visa` or `invalid_preference` if requested network is not valid for the card.
       attr_reader :preferred
     end
-    # The account this card belongs to. This attribute will not be in the card object if the card belongs to a customer or recipient instead. This property is only available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
+    # Attribute for field account
     attr_reader :account
     # City/District/Suburb/Town/Village.
     attr_reader :address_city
@@ -49,7 +49,7 @@ class Networks < Stripe::StripeObject
     attr_reader :brand_product
     # Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you've collected.
     attr_reader :country
-    # Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
+    # Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available when returned as an [External Account](/api/external_account_cards/object) where [controller.is_controller](/api/accounts/object#account_object-controller-is_controller) is `true`.
     attr_reader :currency
     # The customer that this card belongs to. This attribute will not be in the card object if the card belongs to an account or recipient instead.
     attr_reader :customer

lib/stripe/resources/charge.rb

@@ -1167,7 +1167,7 @@ class Zip < Stripe::StripeObject; end
       attr_reader :swish
       # Attribute for field twint
       attr_reader :twint
-      # The type of transaction-specific details of the payment method used in the payment, one of `ach_credit_transfer`, `ach_debit`, `acss_debit`, `alipay`, `au_becs_debit`, `bancontact`, `card`, `card_present`, `eps`, `giropay`, `ideal`, `klarna`, `multibanco`, `p24`, `sepa_debit`, `sofort`, `stripe_account`, or `wechat`.
+      # The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types.
       # An additional hash is included on `payment_method_details` with a name matching this value.
       # It contains information specific to the payment method.
       attr_reader :type
@@ -2908,7 +2908,7 @@ def initialize(amount: nil)
           @amount = amount
         end
       end
-      # The amount to capture, which must be less than or equal to the original amount. Any additional amount will be automatically refunded.
+      # The amount to capture, which must be less than or equal to the original amount.
       attr_accessor :amount
       # An application fee to add on to this charge.
       attr_accessor :application_fee