stripe 15.5.0 → 16.0.0

data/lib/stripe/resources/v2/core/event_destination.rb

@@ -0,0 +1,119 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      # Set up an event destination to receive events from Stripe across multiple destination types, including [webhook endpoints](https://docs.stripe.com/webhooks) and [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge). Event destinations support receiving [thin events](https://docs.stripe.com/api/v2/events) and [snapshot events](https://docs.stripe.com/api/events).
+      class EventDestination < APIResource
+        OBJECT_NAME = "v2.core.event_destination"
+        def self.object_name
+          "v2.core.event_destination"
+        end
+
+        class StatusDetails < Stripe::StripeObject
+          class Disabled < Stripe::StripeObject
+            # Reason event destination has been disabled.
+            attr_reader :reason
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Details about why the event destination has been disabled.
+          attr_reader :disabled
+
+          def self.inner_class_types
+            @inner_class_types = { disabled: Disabled }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class AmazonEventbridge < Stripe::StripeObject
+          # The AWS account ID.
+          attr_reader :aws_account_id
+          # The ARN of the AWS event source.
+          attr_reader :aws_event_source_arn
+          # The state of the AWS event source.
+          attr_reader :aws_event_source_status
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class WebhookEndpoint < Stripe::StripeObject
+          # The signing secret of the webhook endpoint, only includable on creation.
+          attr_reader :signing_secret
+          # The URL of the webhook endpoint, includable.
+          attr_reader :url
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Time at which the object was created.
+        attr_reader :created
+        # An optional description of what the event destination is used for.
+        attr_reader :description
+        # The list of events to enable for this endpoint.
+        attr_reader :enabled_events
+        # Payload type of events being subscribed to.
+        attr_reader :event_payload
+        # Where events should be routed from.
+        attr_reader :events_from
+        # Unique identifier for the object.
+        attr_reader :id
+        # Metadata.
+        attr_reader :metadata
+        # Event destination name.
+        attr_reader :name
+        # String representing the object's type. Objects of the same type share the same value of the object field.
+        attr_reader :object
+        # If using the snapshot event payload, the API version events are rendered as.
+        attr_reader :snapshot_api_version
+        # Status. It can be set to either enabled or disabled.
+        attr_reader :status
+        # Additional information about event destination status.
+        attr_reader :status_details
+        # Event destination type.
+        attr_reader :type
+        # Time at which the object was last updated.
+        attr_reader :updated
+        # 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
+        # Amazon EventBridge configuration.
+        attr_reader :amazon_eventbridge
+        # Webhook endpoint configuration.
+        attr_reader :webhook_endpoint
+
+        def self.inner_class_types
+          @inner_class_types = {
+            status_details: StatusDetails,
+            amazon_eventbridge: AmazonEventbridge,
+            webhook_endpoint: WebhookEndpoint,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+    end
+  end
+end

data/lib/stripe/resources/v2/core/event_notification.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Core
+      class EventReasonRequest
+        attr_reader :id, :idempotency_key
+
+        def initialize(event_reason_request_payload = {})
+          @id = event_reason_request_payload[:id]
+          @idempotency_key = event_reason_request_payload[:idempotency_key]
+        end
+      end
+
+      class EventReason
+        attr_reader :type, :request
+
+        def initialize(event_reason_payload = {})
+          @type = event_reason_payload[:type]
+          @request = EventReasonRequest.new(event_reason_payload[:request])
+        end
+      end
+
+      class RelatedObject
+        attr_reader :id, :type, :url
+
+        def initialize(related_object)
+          @id = related_object[:id]
+          @type = related_object[:type]
+          @url = related_object[:url]
+        end
+      end
+
+      class EventNotification
+        attr_reader :id, :type, :created, :context, :livemode, :reason
+
+        def initialize(event_payload, client)
+          @id = event_payload[:id]
+          @type = event_payload[:type]
+          @created = event_payload[:created]
+          @livemode = event_payload[:livemode]
+          @reason = EventReason.new(event_payload[:reason]) if event_payload[:reason]
+          if event_payload[:context] && !event_payload[:context].empty?
+            @context = StripeContext.parse(event_payload[:context])
+          end
+          # private unless a child declares an attr_reader
+          @related_object = RelatedObject.new(event_payload[:related_object]) if event_payload[:related_object]
+
+          # internal use
+          @client = client
+        end
+
+        # Retrieves the Event that generated this EventNotification.
+        def fetch_event
+          resp = @client.raw_request(:get, "/v2/core/events/#{id}", opts: { stripe_context: context },
+                                                                    usage: ["fetch_event"])
+          @client.deserialize(resp.http_body, api_mode: :v2)
+        end
+      end
+    end
+  end
+end

data/lib/stripe/resources/v2/deleted_object.rb

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class DeletedObject < APIResource
+      # String representing the type of the object that has been deleted. Objects of the same type share the same value of the object field.
+      attr_reader :object
+      # The ID of the object that's being deleted.
+      attr_reader :id
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/webhook_endpoint.rb

@@ -20,91 +20,6 @@ module Stripe
       "webhook_endpoint"
     end
 
-    class DeleteParams < Stripe::RequestParams; end
-
-    class UpdateParams < Stripe::RequestParams
-      # An optional description of what the webhook is used for.
-      attr_accessor :description
-      # Disable the webhook endpoint if set to true.
-      attr_accessor :disabled
-      # The list of events to enable for this endpoint. You may specify `['*']` to enable all events, except those that require explicit selection.
-      attr_accessor :enabled_events
-      # 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
-      # The URL of the webhook endpoint.
-      attr_accessor :url
-
-      def initialize(
-        description: nil,
-        disabled: nil,
-        enabled_events: nil,
-        expand: nil,
-        metadata: nil,
-        url: nil
-      )
-        @description = description
-        @disabled = disabled
-        @enabled_events = enabled_events
-        @expand = expand
-        @metadata = metadata
-        @url = url
-      end
-    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
-      # 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, starting_after: nil)
-        @ending_before = ending_before
-        @expand = expand
-        @limit = limit
-        @starting_after = starting_after
-      end
-    end
-
-    class CreateParams < Stripe::RequestParams
-      # Events sent to this endpoint will be generated with this Stripe Version instead of your account's default Stripe Version.
-      attr_accessor :api_version
-      # Whether this endpoint should receive events from connected accounts (`true`), or from your account (`false`). Defaults to `false`.
-      attr_accessor :connect
-      # An optional description of what the webhook is used for.
-      attr_accessor :description
-      # The list of events to enable for this endpoint. You may specify `['*']` to enable all events, except those that require explicit selection.
-      attr_accessor :enabled_events
-      # 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
-      # The URL of the webhook endpoint.
-      attr_accessor :url
-
-      def initialize(
-        api_version: nil,
-        connect: nil,
-        description: nil,
-        enabled_events: nil,
-        expand: nil,
-        metadata: nil,
-        url: nil
-      )
-        @api_version = api_version
-        @connect = connect
-        @description = description
-        @enabled_events = enabled_events
-        @expand = expand
-        @metadata = metadata
-        @url = url
-      end
-    end
     # The API version events are rendered as for this webhook endpoint.
     attr_reader :api_version
     # The ID of the associated Connect application.
@@ -176,5 +91,13 @@ module Stripe
         opts: opts
       )
     end
+
+    def self.inner_class_types
+      @inner_class_types = {}
+    end
+
+    def self.field_remappings
+      @field_remappings = {}
+    end
   end
 end

data/lib/stripe/resources.rb

@@ -10,6 +10,7 @@ require "stripe/resources/application_fee"
 require "stripe/resources/application_fee_refund"
 require "stripe/resources/apps/secret"
 require "stripe/resources/balance"
+require "stripe/resources/balance_settings"
 require "stripe/resources/balance_transaction"
 require "stripe/resources/bank_account"
 require "stripe/resources/billing/alert"
@@ -140,8 +141,9 @@ require "stripe/resources/treasury/transaction_entry"
 require "stripe/resources/v2/billing/meter_event"
 require "stripe/resources/v2/billing/meter_event_adjustment"
 require "stripe/resources/v2/billing/meter_event_session"
-require "stripe/resources/v2/event"
-require "stripe/resources/v2/event_destination"
+require "stripe/resources/v2/core/event"
+require "stripe/resources/v2/core/event_destination"
+require "stripe/resources/v2/deleted_object"
 require "stripe/resources/webhook_endpoint"
 require "stripe/events/v1_billing_meter_error_report_triggered_event"
 require "stripe/events/v1_billing_meter_no_meter_found_event"

data/lib/stripe/services/account_capability_service.rb

@@ -3,38 +3,6 @@
 
 module Stripe
   class AccountCapabilityService < StripeService
-    class ListParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-
-      def initialize(expand: nil)
-        @expand = expand
-      end
-    end
-
-    class RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-
-      def initialize(expand: nil)
-        @expand = expand
-      end
-    end
-
-    class UpdateParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-      # To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.
-      #
-      # If a capability isn't permanent, you can remove it from the account by passing false. Some capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.
-      attr_accessor :requested
-
-      def initialize(expand: nil, requested: nil)
-        @expand = expand
-        @requested = requested
-      end
-    end
-
     # Returns a list of capabilities associated with the account. The capabilities are returned sorted by creation date, with the most recent capability appearing first.
     def list(account, params = {}, opts = {})
       request(

data/lib/stripe/services/account_external_account_service.rb

@@ -3,255 +3,6 @@
 
 module Stripe
   class AccountExternalAccountService < StripeService
-    class DeleteParams < Stripe::RequestParams; end
-
-    class RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-
-      def initialize(expand: nil)
-        @expand = expand
-      end
-    end
-
-    class UpdateParams < Stripe::RequestParams
-      class Documents < Stripe::RequestParams
-        class BankAccountOwnershipVerification < Stripe::RequestParams
-          # One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
-          attr_accessor :files
-
-          def initialize(files: nil)
-            @files = files
-          end
-        end
-        # One or more documents that support the [Bank account ownership verification](https://support.stripe.com/questions/bank-account-ownership-verification) requirement. Must be a document associated with the bank account that displays the last 4 digits of the account number, either a statement or a check.
-        attr_accessor :bank_account_ownership_verification
-
-        def initialize(bank_account_ownership_verification: nil)
-          @bank_account_ownership_verification = bank_account_ownership_verification
-        end
-      end
-      # The name of the person or business that owns the bank account.
-      attr_accessor :account_holder_name
-      # The type of entity that holds the account. This can be either `individual` or `company`.
-      attr_accessor :account_holder_type
-      # The bank account type. This can only be `checking` or `savings` in most countries. In Japan, this can only be `futsu` or `toza`.
-      attr_accessor :account_type
-      # City/District/Suburb/Town/Village.
-      attr_accessor :address_city
-      # Billing address country, if provided when creating card.
-      attr_accessor :address_country
-      # Address line 1 (Street address/PO Box/Company name).
-      attr_accessor :address_line1
-      # Address line 2 (Apartment/Suite/Unit/Building).
-      attr_accessor :address_line2
-      # State/County/Province/Region.
-      attr_accessor :address_state
-      # ZIP or postal code.
-      attr_accessor :address_zip
-      # When set to true, this becomes the default external account for its currency.
-      attr_accessor :default_for_currency
-      # Documents that may be submitted to satisfy various informational requests.
-      attr_accessor :documents
-      # Two digit number representing the card’s expiration month.
-      attr_accessor :exp_month
-      # Four digit number representing the card’s expiration year.
-      attr_accessor :exp_year
-      # 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
-      # Cardholder name.
-      attr_accessor :name
-
-      def initialize(
-        account_holder_name: nil,
-        account_holder_type: nil,
-        account_type: nil,
-        address_city: nil,
-        address_country: nil,
-        address_line1: nil,
-        address_line2: nil,
-        address_state: nil,
-        address_zip: nil,
-        default_for_currency: nil,
-        documents: nil,
-        exp_month: nil,
-        exp_year: nil,
-        expand: nil,
-        metadata: nil,
-        name: nil
-      )
-        @account_holder_name = account_holder_name
-        @account_holder_type = account_holder_type
-        @account_type = account_type
-        @address_city = address_city
-        @address_country = address_country
-        @address_line1 = address_line1
-        @address_line2 = address_line2
-        @address_state = address_state
-        @address_zip = address_zip
-        @default_for_currency = default_for_currency
-        @documents = documents
-        @exp_month = exp_month
-        @exp_year = exp_year
-        @expand = expand
-        @metadata = metadata
-        @name = name
-      end
-    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
-      # Filter external accounts according to a particular object type.
-      attr_accessor :object
-      # 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, object: nil, starting_after: nil)
-        @ending_before = ending_before
-        @expand = expand
-        @limit = limit
-        @object = object
-        @starting_after = starting_after
-      end
-    end
-
-    class CreateParams < Stripe::RequestParams
-      class BankAccount < Stripe::RequestParams
-        # Attribute for param field object
-        attr_accessor :object
-        # The name of the person or business that owns the bank account.This field is required when attaching the bank account to a `Customer` object.
-        attr_accessor :account_holder_name
-        # The type of entity that holds the account. It can be `company` or `individual`. This field is required when attaching the bank account to a `Customer` object.
-        attr_accessor :account_holder_type
-        # The account number for the bank account, in string form. Must be a checking account.
-        attr_accessor :account_number
-        # The country in which the bank account is located.
-        attr_accessor :country
-        # The currency the bank account is in. This must be a country/currency pairing that [Stripe supports.](docs/payouts)
-        attr_accessor :currency
-        # The routing number, sort code, or other country-appropriate institution number for the bank account. For US bank accounts, this is required and should be the ACH routing number, not the wire routing number. If you are providing an IBAN for `account_number`, this field is not required.
-        attr_accessor :routing_number
-
-        def initialize(
-          object: nil,
-          account_holder_name: nil,
-          account_holder_type: nil,
-          account_number: nil,
-          country: nil,
-          currency: nil,
-          routing_number: nil
-        )
-          @object = object
-          @account_holder_name = account_holder_name
-          @account_holder_type = account_holder_type
-          @account_number = account_number
-          @country = country
-          @currency = currency
-          @routing_number = routing_number
-        end
-      end
-
-      class Card < Stripe::RequestParams
-        # Attribute for param field object
-        attr_accessor :object
-        # Attribute for param field address_city
-        attr_accessor :address_city
-        # Attribute for param field address_country
-        attr_accessor :address_country
-        # Attribute for param field address_line1
-        attr_accessor :address_line1
-        # Attribute for param field address_line2
-        attr_accessor :address_line2
-        # Attribute for param field address_state
-        attr_accessor :address_state
-        # Attribute for param field address_zip
-        attr_accessor :address_zip
-        # Attribute for param field currency
-        attr_accessor :currency
-        # Attribute for param field cvc
-        attr_accessor :cvc
-        # Attribute for param field exp_month
-        attr_accessor :exp_month
-        # Attribute for param field exp_year
-        attr_accessor :exp_year
-        # Attribute for param field name
-        attr_accessor :name
-        # Attribute for param field number
-        attr_accessor :number
-        # 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_accessor :metadata
-
-        def initialize(
-          object: nil,
-          address_city: nil,
-          address_country: nil,
-          address_line1: nil,
-          address_line2: nil,
-          address_state: nil,
-          address_zip: nil,
-          currency: nil,
-          cvc: nil,
-          exp_month: nil,
-          exp_year: nil,
-          name: nil,
-          number: nil,
-          metadata: nil
-        )
-          @object = object
-          @address_city = address_city
-          @address_country = address_country
-          @address_line1 = address_line1
-          @address_line2 = address_line2
-          @address_state = address_state
-          @address_zip = address_zip
-          @currency = currency
-          @cvc = cvc
-          @exp_month = exp_month
-          @exp_year = exp_year
-          @name = name
-          @number = number
-          @metadata = metadata
-        end
-      end
-
-      class CardToken < Stripe::RequestParams
-        # Attribute for param field object
-        attr_accessor :object
-        # Attribute for param field currency
-        attr_accessor :currency
-        # Attribute for param field token
-        attr_accessor :token
-
-        def initialize(object: nil, currency: nil, token: nil)
-          @object = object
-          @currency = currency
-          @token = token
-        end
-      end
-      # When set to true, or if this is the first external account added in this currency, this account becomes the default external account for its currency.
-      attr_accessor :default_for_currency
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-      # A token, like the ones returned by [Stripe.js](https://stripe.com/docs/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead.
-      attr_accessor :external_account
-      # 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
-
-      def initialize(default_for_currency: nil, expand: nil, external_account: nil, metadata: nil)
-        @default_for_currency = default_for_currency
-        @expand = expand
-        @external_account = external_account
-        @metadata = metadata
-      end
-    end
-
     # Create an external account for a given account.
     def create(account, params = {}, opts = {})
       request(

data/lib/stripe/services/account_link_service.rb

@@ -3,54 +3,6 @@
 
 module Stripe
   class AccountLinkService < StripeService
-    class CreateParams < Stripe::RequestParams
-      class CollectionOptions < Stripe::RequestParams
-        # Specifies whether the platform collects only currently_due requirements (`currently_due`) or both currently_due and eventually_due requirements (`eventually_due`). If you don't specify `collection_options`, the default value is `currently_due`.
-        attr_accessor :fields
-        # Specifies whether the platform collects future_requirements in addition to requirements in Connect Onboarding. The default value is `omit`.
-        attr_accessor :future_requirements
-
-        def initialize(fields: nil, future_requirements: nil)
-          @fields = fields
-          @future_requirements = future_requirements
-        end
-      end
-      # The identifier of the account to create an account link for.
-      attr_accessor :account
-      # The collect parameter is deprecated. Use `collection_options` instead.
-      attr_accessor :collect
-      # Specifies the requirements that Stripe collects from connected accounts in the Connect Onboarding flow.
-      attr_accessor :collection_options
-      # Specifies which fields in the response should be expanded.
-      attr_accessor :expand
-      # The URL the user will be redirected to if the account link is expired, has been previously-visited, or is otherwise invalid. The URL you specify should attempt to generate a new account link with the same parameters used to create the original account link, then redirect the user to the new account link's URL so they can continue with Connect Onboarding. If a new account link cannot be generated or the redirect fails you should display a useful error to the user.
-      attr_accessor :refresh_url
-      # The URL that the user will be redirected to upon leaving or completing the linked flow.
-      attr_accessor :return_url
-      # The type of account link the user is requesting.
-      #
-      # You can create Account Links of type `account_update` only for connected accounts where your platform is responsible for collecting requirements, including Custom accounts. You can't create them for accounts that have access to a Stripe-hosted Dashboard. If you use [Connect embedded components](/connect/get-started-connect-embedded-components), you can include components that allow your connected accounts to update their own information. For an account without Stripe-hosted Dashboard access where Stripe is liable for negative balances, you must use embedded components.
-      attr_accessor :type
-
-      def initialize(
-        account: nil,
-        collect: nil,
-        collection_options: nil,
-        expand: nil,
-        refresh_url: nil,
-        return_url: nil,
-        type: nil
-      )
-        @account = account
-        @collect = collect
-        @collection_options = collection_options
-        @expand = expand
-        @refresh_url = refresh_url
-        @return_url = return_url
-        @type = type
-      end
-    end
-
     # Creates an AccountLink object that includes a single-use Stripe URL that the platform can redirect their user to in order to take them through the Connect Onboarding flow.
     def create(params = {}, opts = {})
       request(