stripe 15.2.1 → 15.3.0.pre.beta.2

data/lib/stripe/resources/account_notice.rb

@@ -0,0 +1,123 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A notice to a Connected account. Notice can be sent by Stripe on your behalf or you can opt to send the notices yourself.
+  #
+  # See the [guide to send notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts.
+  class AccountNotice < APIResource
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "account_notice"
+    def self.object_name
+      "account_notice"
+    end
+
+    class Email < Stripe::StripeObject
+      # Content of the email in plain text. The copy must match exactly the language that Stripe Compliance has approved for use.
+      attr_reader :plain_text
+      # Email address of the recipient.
+      attr_reader :recipient
+      # Subject of the email.
+      attr_reader :subject
+    end
+
+    class LinkedObjects < Stripe::StripeObject
+      # Associated [Capability](https://stripe.com/docs/api/capabilities)
+      attr_reader :capability
+      # Associated [Credit Underwriting Record](https://stripe.com/docs/api/issuing/credit_underwriting_record)
+      attr_reader :issuing_credit_underwriting_record
+      # Associated [Issuing Dispute](https://stripe.com/docs/api/issuing/disputes)
+      attr_reader :issuing_dispute
+    end
+
+    class ListParams < Stripe::RequestParams
+      # 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.
+      attr_accessor :ending_before
+      # 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
+      # Set to false to only return unsent AccountNotices.
+      attr_accessor :sent
+      # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
+      attr_accessor :starting_after
+
+      def initialize(ending_before: nil, expand: nil, limit: nil, sent: nil, starting_after: nil)
+        @ending_before = ending_before
+        @expand = expand
+        @limit = limit
+        @sent = sent
+        @starting_after = starting_after
+      end
+    end
+
+    class UpdateParams < Stripe::RequestParams
+      class Email < Stripe::RequestParams
+        # Content of the email in plain text. The copy must match exactly the language that Stripe Compliance has approved for use.
+        attr_accessor :plain_text
+        # Email address of the recipient.
+        attr_accessor :recipient
+        # Subject of the email.
+        attr_accessor :subject
+
+        def initialize(plain_text: nil, recipient: nil, subject: nil)
+          @plain_text = plain_text
+          @recipient = recipient
+          @subject = subject
+        end
+      end
+      # Information about the email you sent.
+      attr_accessor :email
+      # 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`.
+      attr_accessor :metadata
+      # Date when you sent the notice.
+      attr_accessor :sent_at
+
+      def initialize(email: nil, expand: nil, metadata: nil, sent_at: nil)
+        @email = email
+        @expand = expand
+        @metadata = metadata
+        @sent_at = sent_at
+      end
+    end
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # When present, the deadline for sending the notice to meet the relevant regulations.
+    attr_reader :deadline
+    # Information about the email when sent.
+    attr_reader :email
+    # Unique identifier for the object.
+    attr_reader :id
+    # Information about objects related to the notice.
+    attr_reader :linked_objects
+    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    attr_reader :livemode
+    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    attr_reader :metadata
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Reason the notice is being sent. The reason determines what copy the notice must contain. See the [regulated customer notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) guide. All reasons might not apply to your integration, and Stripe might add new reasons in the future, so we recommend an internal warning when you receive an unknown reason.
+    attr_reader :reason
+    # Date when the notice was sent. When absent, you must send the notice, update the content of the email and date when it was sent.
+    attr_reader :sent_at
+
+    # Retrieves a list of AccountNotice objects. The objects are sorted in descending order by creation date, with the most-recently-created object appearing first.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/account_notices", params: params, opts: opts)
+    end
+
+    # Updates an AccountNotice object.
+    def self.update(account_notice, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/account_notices/%<account_notice>s", { account_notice: CGI.escape(account_notice) }),
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end

data/lib/stripe/resources/account_session.rb

@@ -63,6 +63,30 @@ module Stripe
         attr_reader :features
       end
 
+      class CapitalFinancing < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
+      class CapitalFinancingApplication < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
+      class CapitalFinancingPromotion < Stripe::StripeObject
+        class Features < Stripe::StripeObject; end
+        # Whether the embedded component is enabled.
+        attr_reader :enabled
+        # Attribute for field features
+        attr_reader :features
+      end
+
       class DisputesList < Stripe::StripeObject
         class Features < Stripe::StripeObject
           # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -262,6 +286,12 @@ module Stripe
       attr_reader :account_onboarding
       # Attribute for field balances
       attr_reader :balances
+      # Attribute for field capital_financing
+      attr_reader :capital_financing
+      # Attribute for field capital_financing_application
+      attr_reader :capital_financing_application
+      # Attribute for field capital_financing_promotion
+      attr_reader :capital_financing_promotion
       # Attribute for field disputes_list
       attr_reader :disputes_list
       # Attribute for field documents
@@ -346,6 +376,46 @@ module Stripe
           end
         end
 
+        class AppInstall < Stripe::RequestParams
+          class Features < Stripe::RequestParams
+            # List of apps allowed to be enabled for this account session.
+            attr_accessor :allowed_apps
+
+            def initialize(allowed_apps: nil)
+              @allowed_apps = allowed_apps
+            end
+          end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class AppViewport < Stripe::RequestParams
+          class Features < Stripe::RequestParams
+            # List of apps allowed to be enabled for this account session.
+            attr_accessor :allowed_apps
+
+            def initialize(allowed_apps: nil)
+              @allowed_apps = allowed_apps
+            end
+          end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class Balances < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Disables Stripe user authentication for this embedded component. This value can only be true for accounts where `controller.requirement_collection` is `application`. The default value is the opposite of the `external_account_collection` value. For example, if you don’t set `external_account_collection`, it defaults to true and `disable_stripe_user_authentication` defaults to false.
@@ -384,6 +454,58 @@ module Stripe
           end
         end
 
+        class CapitalFinancing < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class CapitalFinancingApplication < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class CapitalFinancingPromotion < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class CapitalOverview < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class DisputesList < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -431,6 +553,19 @@ module Stripe
           end
         end
 
+        class ExportTaxTransactions < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class FinancialAccount < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Disables Stripe user authentication for this embedded component. This value can only be true for accounts where `controller.requirement_collection` is `application`. The default value is the opposite of the `external_account_collection` value. For example, if you don’t set `external_account_collection`, it defaults to true and `disable_stripe_user_authentication` defaults to false.
@@ -647,6 +782,19 @@ module Stripe
           end
         end
 
+        class PaymentMethodSettings < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class Payments < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -732,6 +880,52 @@ module Stripe
           end
         end
 
+        class ProductTaxCodeSelector < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class Recipients < Stripe::RequestParams
+          class Features < Stripe::RequestParams
+            # Whether to allow sending money.
+            attr_accessor :send_money
+
+            def initialize(send_money: nil)
+              @send_money = send_money
+            end
+          end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # Attribute for param field features
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
+        class ReportingChart < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class TaxRegistrations < Stripe::RequestParams
           class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
@@ -757,16 +951,43 @@ module Stripe
             @features = features
           end
         end
+
+        class TaxThresholdMonitoring < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
         # Configuration for the account management embedded component.
         attr_accessor :account_management
         # Configuration for the account onboarding embedded component.
         attr_accessor :account_onboarding
+        # Configuration for the app install component.
+        attr_accessor :app_install
+        # Configuration for the app viewport component.
+        attr_accessor :app_viewport
         # Configuration for the balances embedded component.
         attr_accessor :balances
+        # Configuration for the capital financing embedded component.
+        attr_accessor :capital_financing
+        # Configuration for the capital financing application embedded component.
+        attr_accessor :capital_financing_application
+        # Configuration for the capital financing promotion embedded component.
+        attr_accessor :capital_financing_promotion
+        # Configuration for the capital overview embedded component.
+        attr_accessor :capital_overview
         # Configuration for the disputes list embedded component.
         attr_accessor :disputes_list
         # Configuration for the documents embedded component.
         attr_accessor :documents
+        # Configuration for the export tax transactions embedded component.
+        attr_accessor :export_tax_transactions
         # Configuration for the financial account embedded component.
         attr_accessor :financial_account
         # Configuration for the financial account transactions embedded component.
@@ -781,23 +1002,40 @@ module Stripe
         attr_accessor :payment_details
         # Configuration for the payment disputes embedded component.
         attr_accessor :payment_disputes
+        # Configuration for the payment method settings embedded component.
+        attr_accessor :payment_method_settings
         # Configuration for the payments embedded component.
         attr_accessor :payments
         # Configuration for the payouts embedded component.
         attr_accessor :payouts
         # Configuration for the payouts list embedded component.
         attr_accessor :payouts_list
+        # Configuration for the product tax code selector embedded component.
+        attr_accessor :product_tax_code_selector
+        # Configuration for the recipients component.
+        attr_accessor :recipients
+        # Configuration for the reporting chart embedded component.
+        attr_accessor :reporting_chart
         # Configuration for the tax registrations embedded component.
         attr_accessor :tax_registrations
         # Configuration for the tax settings embedded component.
         attr_accessor :tax_settings
+        # Configuration for the tax threshold monitoring embedded component.
+        attr_accessor :tax_threshold_monitoring
 
         def initialize(
           account_management: nil,
           account_onboarding: nil,
+          app_install: nil,
+          app_viewport: nil,
           balances: nil,
+          capital_financing: nil,
+          capital_financing_application: nil,
+          capital_financing_promotion: nil,
+          capital_overview: nil,
           disputes_list: nil,
           documents: nil,
+          export_tax_transactions: nil,
           financial_account: nil,
           financial_account_transactions: nil,
           issuing_card: nil,
@@ -805,17 +1043,29 @@ module Stripe
           notification_banner: nil,
           payment_details: nil,
           payment_disputes: nil,
+          payment_method_settings: nil,
           payments: nil,
           payouts: nil,
           payouts_list: nil,
+          product_tax_code_selector: nil,
+          recipients: nil,
+          reporting_chart: nil,
           tax_registrations: nil,
-          tax_settings: nil
+          tax_settings: nil,
+          tax_threshold_monitoring: nil
         )
           @account_management = account_management
           @account_onboarding = account_onboarding
+          @app_install = app_install
+          @app_viewport = app_viewport
           @balances = balances
+          @capital_financing = capital_financing
+          @capital_financing_application = capital_financing_application
+          @capital_financing_promotion = capital_financing_promotion
+          @capital_overview = capital_overview
           @disputes_list = disputes_list
           @documents = documents
+          @export_tax_transactions = export_tax_transactions
           @financial_account = financial_account
           @financial_account_transactions = financial_account_transactions
           @issuing_card = issuing_card
@@ -823,11 +1073,16 @@ module Stripe
           @notification_banner = notification_banner
           @payment_details = payment_details
           @payment_disputes = payment_disputes
+          @payment_method_settings = payment_method_settings
           @payments = payments
           @payouts = payouts
           @payouts_list = payouts_list
+          @product_tax_code_selector = product_tax_code_selector
+          @recipients = recipients
+          @reporting_chart = reporting_chart
           @tax_registrations = tax_registrations
           @tax_settings = tax_settings
+          @tax_threshold_monitoring = tax_threshold_monitoring
         end
       end
       # The identifier of the account to create an Account Session for.

data/lib/stripe/resources/balance_settings.rb

@@ -0,0 +1,105 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # Options for customizing account balances and payout settings for a Stripe platform's connected accounts.
+  #
+  # This API is only available for users enrolled in the public preview for Accounts v2 on Stripe Connect.
+  # If you are not in this preview, please use the [Accounts v1 API](https://docs.stripe.com/api/accounts?api-version=2025-03-31.basil)
+  # to manage your connected accounts' balance settings instead.
+  class BalanceSettings < SingletonAPIResource
+    include Stripe::APIOperations::SingletonSave
+
+    OBJECT_NAME = "balance_settings"
+    def self.object_name
+      "balance_settings"
+    end
+
+    class Payouts < Stripe::StripeObject
+      class Schedule < Stripe::StripeObject
+        # How frequently funds will be paid out. One of `manual` (payouts only created via API call), `daily`, `weekly`, or `monthly`.
+        attr_reader :interval
+        # The day of the month funds will be paid out. Only shown if `interval` is monthly. Payouts scheduled between the 29th and 31st of the month are sent on the last day of shorter months.
+        attr_reader :monthly_anchor
+        # The day of the week funds will be paid out, of the style 'monday', 'tuesday', etc. Only shown if `interval` is weekly.
+        attr_reader :weekly_anchor
+      end
+      # Details on when funds from charges are available, and when they are paid out to an external account. See our [Setting Bank and Debit Card Payouts](https://stripe.com/docs/connect/bank-transfers#payout-information) documentation for details.
+      attr_reader :schedule
+      # The text that appears on the bank account statement for payouts. If not set, this defaults to the platform's bank descriptor as set in the Dashboard.
+      attr_reader :statement_descriptor
+      # Whether the funds in this account can be paid out.
+      attr_reader :status
+    end
+
+    class SettlementTiming < Stripe::StripeObject
+      # The number of days charge funds are held before becoming available.
+      attr_reader :delay_days
+    end
+
+    class UpdateParams < Stripe::RequestParams
+      class Payouts < Stripe::RequestParams
+        class Schedule < Stripe::RequestParams
+          # How frequently available funds are paid out. One of: `daily`, `manual`, `weekly`, or `monthly`. Default is `daily`.
+          attr_accessor :interval
+          # The day of the month when available funds are paid out, specified as a number between 1--31. Payouts nominally scheduled between the 29th and 31st of the month are instead sent on the last day of a shorter month. Required and applicable only if `interval` is `monthly`.
+          attr_accessor :monthly_anchor
+          # The day of the week when available funds are paid out (required and applicable only if `interval` is `weekly`.)
+          attr_accessor :weekly_anchor
+
+          def initialize(interval: nil, monthly_anchor: nil, weekly_anchor: nil)
+            @interval = interval
+            @monthly_anchor = monthly_anchor
+            @weekly_anchor = weekly_anchor
+          end
+        end
+        # Details on when funds from charges are available, and when they are paid out to an external account. For details, see our [Setting Bank and Debit Card Payouts](/connect/bank-transfers#payout-information) documentation.
+        attr_accessor :schedule
+        # The text that appears on the bank account statement for payouts. If not set, this defaults to the platform's bank descriptor as set in the Dashboard.
+        attr_accessor :statement_descriptor
+
+        def initialize(schedule: nil, statement_descriptor: nil)
+          @schedule = schedule
+          @statement_descriptor = statement_descriptor
+        end
+      end
+
+      class SettlementTiming < Stripe::RequestParams
+        # The number of days charge funds are held before becoming available. May also be set to `minimum`, representing the lowest available value for the account country. Default is `minimum`. The `delay_days` parameter remains at the last configured value if `payouts.schedule.interval` is `manual`. [Learn more about controlling payout delay days](/connect/manage-payout-schedule).
+        attr_accessor :delay_days
+
+        def initialize(delay_days: nil)
+          @delay_days = delay_days
+        end
+      end
+      # A Boolean indicating whether Stripe should try to reclaim negative balances from an attached bank account. For details, see [Understanding Connect Account Balances](/connect/account-balances).
+      attr_accessor :debit_negative_balances
+      # Specifies which fields in the response should be expanded.
+      attr_accessor :expand
+      # Settings specific to the account's payouts.
+      attr_accessor :payouts
+      # Settings related to the account's balance settlement timing.
+      attr_accessor :settlement_timing
+
+      def initialize(
+        debit_negative_balances: nil,
+        expand: nil,
+        payouts: nil,
+        settlement_timing: nil
+      )
+        @debit_negative_balances = debit_negative_balances
+        @expand = expand
+        @payouts = payouts
+        @settlement_timing = settlement_timing
+      end
+    end
+    # A Boolean indicating if Stripe should try to reclaim negative balances from an attached bank account. See [Understanding Connect account balances](/connect/account-balances) for details. The default value is `false` when [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts, otherwise `true`.
+    attr_reader :debit_negative_balances
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Settings specific to the account's payouts.
+    attr_reader :payouts
+    # Attribute for field settlement_timing
+    attr_reader :settlement_timing
+  end
+end

data/lib/stripe/resources/billing/credit_balance_summary.rb

@@ -45,6 +45,8 @@ module Stripe
       attr_reader :balances
       # The customer the balance is for.
       attr_reader :customer
+      # The account the balance is for.
+      attr_reader :customer_account
       # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.

data/lib/stripe/resources/billing/credit_balance_transaction.rb

@@ -73,6 +73,8 @@ module Stripe
         attr_accessor :credit_grant
         # The customer for which to fetch credit balance transactions.
         attr_accessor :customer
+        # The account for which to fetch credit balance transactions.
+        attr_accessor :customer_account
         # 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.
         attr_accessor :ending_before
         # Specifies which fields in the response should be expanded.
@@ -85,6 +87,7 @@ module Stripe
         def initialize(
           credit_grant: nil,
           customer: nil,
+          customer_account: nil,
           ending_before: nil,
           expand: nil,
           limit: nil,
@@ -92,6 +95,7 @@ module Stripe
         )
           @credit_grant = credit_grant
           @customer = customer
+          @customer_account = customer_account
           @ending_before = ending_before
           @expand = expand
           @limit = limit