stripe 12.5.0 → 15.0.0

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

@@ -0,0 +1,41 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    # Events are generated to keep you informed of activity in your business account. APIs in the /v2 namespace generate [thin events](https://docs.stripe.com/event-destinations#benefits-of-thin-events) which have small, unversioned payloads that include a reference to the ID of the object that has changed. The Events v2 API returns these new thin events. [Retrieve the event object](https://docs.stripe.com/event-destinations#fetch-data) for additional data about the event. Use the related object ID in the event payload to [fetch the API resource](https://docs.stripe.com/event-destinations#retrieve-the-object-associated-with-thin-events) of the object associated with the event. Comparatively, events generated by most API v1 include a versioned snapshot of an API object in their payload.
+    class Event < APIResource
+      OBJECT_NAME = "v2.core.event"
+      def self.object_name
+        "v2.core.event"
+      end
+
+      class Reason < Stripe::StripeObject
+        class Request < Stripe::StripeObject
+          # ID of the API request that caused the event.
+          attr_reader :id
+          # The idempotency key transmitted during the request.
+          attr_reader :idempotency_key
+        end
+        # Event reason type.
+        attr_reader :type
+        # Information on the API request that instigated the event.
+        attr_reader :request
+      end
+      # Authentication context needed to fetch the event or related object.
+      attr_reader :context
+      # Time at which the object was created.
+      attr_reader :created
+      # Unique identifier for the event.
+      attr_reader :id
+      # 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 of the object field.
+      attr_reader :object
+      # Reason for the event.
+      attr_reader :reason
+      # The type of the event.
+      attr_reader :type
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    # 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
+        end
+        # Details about why the event destination has been disabled.
+        attr_reader :disabled
+      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
+      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
+      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
+      # 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
+      # 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
+      # Amazon EventBridge configuration.
+      attr_reader :amazon_eventbridge
+      # Webhook endpoint configuration.
+      attr_reader :webhook_endpoint
+    end
+  end
+end

data/lib/stripe/resources/webhook_endpoint.rb

@@ -20,6 +20,119 @@ 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.
+    attr_reader :application
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # An optional description of what the webhook is used for.
+    attr_reader :description
+    # The list of events to enable for this endpoint. `['*']` indicates that all events are enabled, except those that require explicit selection.
+    attr_reader :enabled_events
+    # Unique identifier for the object.
+    attr_reader :id
+    # 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
+    # The endpoint's secret, used to generate [webhook signatures](https://docs.stripe.com/webhooks/signatures). Only returned at creation.
+    attr_reader :secret
+    # The status of the webhook. It can be `enabled` or `disabled`.
+    attr_reader :status
+    # The URL of the webhook endpoint.
+    attr_reader :url
+    # Always true for a deleted object
+    attr_reader :deleted
+
     # A webhook endpoint must have a url and a list of enabled_events. You may optionally specify the Boolean connect parameter. If set to true, then a Connect webhook endpoint that notifies the specified url about events from all connected accounts is created; otherwise an account webhook endpoint that notifies the specified url only about events from your account is created. You can also create webhook endpoints in the [webhooks settings](https://dashboard.stripe.com/account/webhooks) section of the Dashboard.
     def self.create(params = {}, opts = {})
       request_stripe_object(
@@ -31,10 +144,10 @@ module Stripe
     end
 
     # You can also delete webhook endpoints via the [webhook endpoint management](https://dashboard.stripe.com/account/webhooks) page of the Stripe dashboard.
-    def self.delete(id, params = {}, opts = {})
+    def self.delete(webhook_endpoint, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
-        path: format("/v1/webhook_endpoints/%<id>s", { id: CGI.escape(id) }),
+        path: format("/v1/webhook_endpoints/%<webhook_endpoint>s", { webhook_endpoint: CGI.escape(webhook_endpoint) }),
         params: params,
         opts: opts
       )
@@ -51,20 +164,15 @@ module Stripe
     end
 
     # Returns a list of your webhook endpoints.
-    def self.list(filters = {}, opts = {})
-      request_stripe_object(
-        method: :get,
-        path: "/v1/webhook_endpoints",
-        params: filters,
-        opts: opts
-      )
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/webhook_endpoints", params: params, opts: opts)
     end
 
     # Updates the webhook endpoint. You may edit the url, the list of enabled_events, and the status of your endpoint.
-    def self.update(id, params = {}, opts = {})
+    def self.update(webhook_endpoint, params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: format("/v1/webhook_endpoints/%<id>s", { id: CGI.escape(id) }),
+        path: format("/v1/webhook_endpoints/%<webhook_endpoint>s", { webhook_endpoint: CGI.escape(webhook_endpoint) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources.rb

@@ -5,6 +5,7 @@ require "stripe/resources/account"
 require "stripe/resources/account_link"
 require "stripe/resources/account_session"
 require "stripe/resources/apple_pay_domain"
+require "stripe/resources/application"
 require "stripe/resources/application_fee"
 require "stripe/resources/application_fee_refund"
 require "stripe/resources/apps/secret"
@@ -12,6 +13,10 @@ require "stripe/resources/balance"
 require "stripe/resources/balance_transaction"
 require "stripe/resources/bank_account"
 require "stripe/resources/billing/alert"
+require "stripe/resources/billing/alert_triggered"
+require "stripe/resources/billing/credit_balance_summary"
+require "stripe/resources/billing/credit_balance_transaction"
+require "stripe/resources/billing/credit_grant"
 require "stripe/resources/billing/meter"
 require "stripe/resources/billing/meter_event"
 require "stripe/resources/billing/meter_event_adjustment"
@@ -27,6 +32,7 @@ require "stripe/resources/climate/order"
 require "stripe/resources/climate/product"
 require "stripe/resources/climate/supplier"
 require "stripe/resources/confirmation_token"
+require "stripe/resources/connect_collection_transfer"
 require "stripe/resources/country_spec"
 require "stripe/resources/coupon"
 require "stripe/resources/credit_note"
@@ -38,6 +44,7 @@ require "stripe/resources/customer_session"
 require "stripe/resources/discount"
 require "stripe/resources/dispute"
 require "stripe/resources/entitlements/active_entitlement"
+require "stripe/resources/entitlements/active_entitlement_summary"
 require "stripe/resources/entitlements/feature"
 require "stripe/resources/ephemeral_key"
 require "stripe/resources/event"
@@ -56,6 +63,8 @@ require "stripe/resources/identity/verification_session"
 require "stripe/resources/invoice"
 require "stripe/resources/invoice_item"
 require "stripe/resources/invoice_line_item"
+require "stripe/resources/invoice_payment"
+require "stripe/resources/invoice_rendering_template"
 require "stripe/resources/issuing/authorization"
 require "stripe/resources/issuing/card"
 require "stripe/resources/issuing/cardholder"
@@ -86,6 +95,7 @@ require "stripe/resources/radar/value_list_item"
 require "stripe/resources/refund"
 require "stripe/resources/reporting/report_run"
 require "stripe/resources/reporting/report_type"
+require "stripe/resources/reserve_transaction"
 require "stripe/resources/reversal"
 require "stripe/resources/review"
 require "stripe/resources/setup_attempt"
@@ -93,6 +103,7 @@ require "stripe/resources/setup_intent"
 require "stripe/resources/shipping_rate"
 require "stripe/resources/sigma/scheduled_query_run"
 require "stripe/resources/source"
+require "stripe/resources/source_mandate_notification"
 require "stripe/resources/source_transaction"
 require "stripe/resources/subscription"
 require "stripe/resources/subscription_item"
@@ -104,6 +115,7 @@ require "stripe/resources/tax/settings"
 require "stripe/resources/tax/transaction"
 require "stripe/resources/tax/transaction_line_item"
 require "stripe/resources/tax_code"
+require "stripe/resources/tax_deducted_at_source"
 require "stripe/resources/tax_id"
 require "stripe/resources/tax_rate"
 require "stripe/resources/terminal/configuration"
@@ -125,6 +137,11 @@ require "stripe/resources/treasury/received_credit"
 require "stripe/resources/treasury/received_debit"
 require "stripe/resources/treasury/transaction"
 require "stripe/resources/treasury/transaction_entry"
-require "stripe/resources/usage_record"
-require "stripe/resources/usage_record_summary"
+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/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/search_result_object.rb

@@ -20,7 +20,7 @@ module Stripe
     # that there isn't a next page in order to replicate the behavior of the API
     # when it attempts to return a page beyond the last.
     def self.empty_search_result(opts = {})
-      SearchResultObject.construct_from({ data: [] }, opts)
+      SearchResultObject.construct_from({ data: [] }, opts, :v1)
     end
 
     def initialize(*args)

data/lib/stripe/services/account_capability_service.rb

@@ -0,0 +1,71 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+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(
+        method: :get,
+        path: format("/v1/accounts/%<account>s/capabilities", { account: CGI.escape(account) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves information about the specified Account Capability.
+    def retrieve(account, capability, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/accounts/%<account>s/capabilities/%<capability>s", { account: CGI.escape(account), capability: CGI.escape(capability) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Updates an existing Account Capability. Request or remove a capability by updating its requested parameter.
+    def update(account, capability, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/accounts/%<account>s/capabilities/%<capability>s", { account: CGI.escape(account), capability: CGI.escape(capability) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end