stripe 13.4.0 → 13.5.0.pre.beta.1

data/rbi/stripe/resources/gift_cards/transaction.rbi

@@ -0,0 +1,257 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module GiftCards
+    # A gift card transaction represents a single transaction on a referenced gift card.
+    # A transaction is in one of three states, `confirmed`, `held` or `canceled`. A `confirmed`
+    # transaction is one that has added/deducted funds. A `held` transaction has created a
+    # temporary hold on funds, which can then be cancelled or confirmed. A `held` transaction
+    # can be confirmed into a `confirmed` transaction, or canceled into a `canceled` transaction.
+    # A `canceled` transaction has no effect on a gift card's balance.
+    class Transaction < APIResource
+      class CreatedBy < Stripe::StripeObject
+        class Checkout < Stripe::StripeObject
+          # The Stripe CheckoutSession that created this object.
+          sig { returns(String) }
+          attr_reader :checkout_session
+          # The Stripe CheckoutSession LineItem that created this object.
+          sig { returns(T.nilable(String)) }
+          attr_reader :line_item
+        end
+        class Order < Stripe::StripeObject
+          # The Stripe Order LineItem that created this object.
+          sig { returns(T.nilable(String)) }
+          attr_reader :line_item
+          # The Stripe Order that created this object.
+          sig { returns(String) }
+          attr_reader :order
+        end
+        class Payment < Stripe::StripeObject
+          # The PaymentIntent that created this object.
+          sig { returns(String) }
+          attr_reader :payment_intent
+        end
+        # Attribute for field checkout
+        sig { returns(Checkout) }
+        attr_reader :checkout
+        # Attribute for field order
+        sig { returns(Order) }
+        attr_reader :order
+        # Attribute for field payment
+        sig { returns(Payment) }
+        attr_reader :payment
+        # The type of event that created this object.
+        sig { returns(String) }
+        attr_reader :type
+      end
+      # The amount of this transaction. A positive value indicates that funds were added to the gift card. A negative value indicates that funds were removed from the gift card.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :amount
+      # Time at which the transaction was confirmed. Measured in seconds since the Unix epoch.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :confirmed_at
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :created
+      # The related Stripe objects that created this gift card transaction.
+      sig { returns(T.nilable(CreatedBy)) }
+      attr_reader :created_by
+      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+      sig { returns(T.nilable(String)) }
+      attr_reader :currency
+      # An arbitrary string attached to the object. Often useful for displaying to users.
+      sig { returns(T.nilable(String)) }
+      attr_reader :description
+      # The gift card that this transaction occurred on
+      sig { returns(T.nilable(String)) }
+      attr_reader :gift_card
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_reader :id
+      # 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.
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_reader :metadata
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      attr_reader :object
+      # Status of this transaction, one of `held`, `confirmed`, or `canceled`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :status
+      # A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
+      sig { returns(T.nilable(String)) }
+      attr_reader :transfer_group
+      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.
+        sig { returns(String) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The gift card to list transactions for.
+        sig { returns(String) }
+        attr_accessor :gift_card
+        # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
+        sig { returns(Integer) }
+        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.
+        sig { returns(String) }
+        attr_accessor :starting_after
+        # A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
+        sig { returns(String) }
+        attr_accessor :transfer_group
+        sig {
+          params(ending_before: String, expand: T::Array[String], gift_card: String, limit: Integer, starting_after: String, transfer_group: String).void
+         }
+        def initialize(
+          ending_before: nil,
+          expand: nil,
+          gift_card: nil,
+          limit: nil,
+          starting_after: nil,
+          transfer_group: nil
+        ); end
+      end
+      class CreateParams < Stripe::RequestParams
+        class CreatedBy < Stripe::RequestParams
+          class Payment < Stripe::RequestParams
+            # The PaymentIntent used to collect payment for this object.
+            sig { returns(String) }
+            attr_accessor :payment_intent
+            sig { params(payment_intent: String).void }
+            def initialize(payment_intent: nil); end
+          end
+          # The details for the payment that created this object.
+          sig { returns(::Stripe::GiftCards::Transaction::CreateParams::CreatedBy::Payment) }
+          attr_accessor :payment
+          # The type of event that created this object.
+          sig { returns(String) }
+          attr_accessor :type
+          sig {
+            params(payment: ::Stripe::GiftCards::Transaction::CreateParams::CreatedBy::Payment, type: String).void
+           }
+          def initialize(payment: nil, type: nil); end
+        end
+        # The amount of the transaction. A negative amount deducts funds, and a positive amount adds funds.
+        sig { returns(Integer) }
+        attr_accessor :amount
+        # Whether this is a confirmed transaction. A confirmed transaction immediately deducts from/adds to the `amount_available` on the gift card. Otherwise, it creates a held transaction that increments the `amount_held` on the gift card.
+        sig { returns(T::Boolean) }
+        attr_accessor :confirm
+        # Related objects which created this transaction.
+        sig { returns(::Stripe::GiftCards::Transaction::CreateParams::CreatedBy) }
+        attr_accessor :created_by
+        # The currency of the transaction. This must match the currency of the gift card.
+        sig { returns(String) }
+        attr_accessor :currency
+        # An arbitrary string attached to the object. Often useful for displaying to users.
+        sig { returns(String) }
+        attr_accessor :description
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The gift card to create a new transaction on.
+        sig { returns(String) }
+        attr_accessor :gift_card
+        # 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`.
+        sig { returns(T::Hash[String, String]) }
+        attr_accessor :metadata
+        # A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
+        sig { returns(String) }
+        attr_accessor :transfer_group
+        sig {
+          params(amount: Integer, confirm: T::Boolean, created_by: ::Stripe::GiftCards::Transaction::CreateParams::CreatedBy, currency: String, description: String, expand: T::Array[String], gift_card: String, metadata: T::Hash[String, String], transfer_group: String).void
+         }
+        def initialize(
+          amount: nil,
+          confirm: nil,
+          created_by: nil,
+          currency: nil,
+          description: nil,
+          expand: nil,
+          gift_card: nil,
+          metadata: nil,
+          transfer_group: nil
+        ); end
+      end
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class UpdateParams < Stripe::RequestParams
+        # An arbitrary string attached to the object. Often useful for displaying to users.
+        sig { returns(String) }
+        attr_accessor :description
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        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`.
+        sig { returns(T.nilable(T::Hash[String, String])) }
+        attr_accessor :metadata
+        sig {
+          params(description: String, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String])).void
+         }
+        def initialize(description: nil, expand: nil, metadata: nil); end
+      end
+      class CancelParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      class ConfirmParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      # Cancel a gift card transaction
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Transaction::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def cancel(params = {}, opts = {}); end
+
+      # Cancel a gift card transaction
+      sig {
+        params(id: String, params: T.any(::Stripe::GiftCards::Transaction::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def self.cancel(id, params = {}, opts = {}); end
+
+      # Confirm a gift card transaction
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Transaction::ConfirmParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def confirm(params = {}, opts = {}); end
+
+      # Confirm a gift card transaction
+      sig {
+        params(id: String, params: T.any(::Stripe::GiftCards::Transaction::ConfirmParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def self.confirm(id, params = {}, opts = {}); end
+
+      # Create a gift card transaction
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Transaction::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def self.create(params = {}, opts = {}); end
+
+      # List gift card transactions for a gift card
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Transaction::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+
+      # Update a gift card transaction
+      sig {
+        params(id: String, params: T.any(::Stripe::GiftCards::Transaction::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Transaction)
+       }
+      def self.update(id, params = {}, opts = {}); end
+    end
+  end
+end

data/rbi/stripe/resources/identity/verification_report.rbi

@@ -0,0 +1,354 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module Identity
+    # A VerificationReport is the result of an attempt to collect and verify data from a user.
+    # The collection of verification checks performed is determined from the `type` and `options`
+    # parameters used. You can find the result of each verification check performed in the
+    # appropriate sub-resource: `document`, `id_number`, `selfie`.
+    #
+    # Each VerificationReport contains a copy of any data collected by the user as well as
+    # reference IDs which can be used to access collected images through the [FileUpload](https://stripe.com/docs/api/files)
+    # API. To configure and create VerificationReports, use the
+    # [VerificationSession](https://stripe.com/docs/api/identity/verification_sessions) API.
+    #
+    # Related guide: [Accessing verification results](https://stripe.com/docs/identity/verification-sessions#results).
+    class VerificationReport < APIResource
+      class Document < Stripe::StripeObject
+        class Address < Stripe::StripeObject
+          # City, district, suburb, town, or village.
+          sig { returns(T.nilable(String)) }
+          attr_reader :city
+          # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+          sig { returns(T.nilable(String)) }
+          attr_reader :country
+          # Address line 1 (e.g., street, PO Box, or company name).
+          sig { returns(T.nilable(String)) }
+          attr_reader :line1
+          # Address line 2 (e.g., apartment, suite, unit, or building).
+          sig { returns(T.nilable(String)) }
+          attr_reader :line2
+          # ZIP or postal code.
+          sig { returns(T.nilable(String)) }
+          attr_reader :postal_code
+          # State, county, province, or region.
+          sig { returns(T.nilable(String)) }
+          attr_reader :state
+        end
+        class Dob < Stripe::StripeObject
+          # Numerical day between 1 and 31.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :day
+          # Numerical month between 1 and 12.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :month
+          # The four-digit year.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :year
+        end
+        class Error < Stripe::StripeObject
+          # A short machine-readable string giving the reason for the verification failure.
+          sig { returns(T.nilable(String)) }
+          attr_reader :code
+          # A human-readable message giving the reason for the failure. These messages can be shown to your users.
+          sig { returns(T.nilable(String)) }
+          attr_reader :reason
+        end
+        class ExpirationDate < Stripe::StripeObject
+          # Numerical day between 1 and 31.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :day
+          # Numerical month between 1 and 12.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :month
+          # The four-digit year.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :year
+        end
+        class IssuedDate < Stripe::StripeObject
+          # Numerical day between 1 and 31.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :day
+          # Numerical month between 1 and 12.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :month
+          # The four-digit year.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :year
+        end
+        # Address as it appears in the document.
+        sig { returns(T.nilable(Address)) }
+        attr_reader :address
+        # Date of birth as it appears in the document.
+        sig { returns(T.nilable(Dob)) }
+        attr_reader :dob
+        # Details on the verification error. Present when status is `unverified`.
+        sig { returns(T.nilable(Error)) }
+        attr_reader :error
+        # Expiration date of the document.
+        sig { returns(T.nilable(ExpirationDate)) }
+        attr_reader :expiration_date
+        # Array of [File](https://stripe.com/docs/api/files) ids containing images for this document.
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :files
+        # First name as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :first_name
+        # Issued date of the document.
+        sig { returns(T.nilable(IssuedDate)) }
+        attr_reader :issued_date
+        # Issuing country of the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :issuing_country
+        # Last name as it appears in the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :last_name
+        # Document ID number.
+        sig { returns(T.nilable(String)) }
+        attr_reader :number
+        # Status of this `document` check.
+        sig { returns(String) }
+        attr_reader :status
+        # Type of the document.
+        sig { returns(T.nilable(String)) }
+        attr_reader :type
+      end
+      class Email < Stripe::StripeObject
+        class Error < Stripe::StripeObject
+          # A short machine-readable string giving the reason for the verification failure.
+          sig { returns(T.nilable(String)) }
+          attr_reader :code
+          # A human-readable message giving the reason for the failure. These messages can be shown to your users.
+          sig { returns(T.nilable(String)) }
+          attr_reader :reason
+        end
+        # Email to be verified.
+        sig { returns(T.nilable(String)) }
+        attr_reader :email
+        # Details on the verification error. Present when status is `unverified`.
+        sig { returns(T.nilable(Error)) }
+        attr_reader :error
+        # Status of this `email` check.
+        sig { returns(String) }
+        attr_reader :status
+      end
+      class IdNumber < Stripe::StripeObject
+        class Dob < Stripe::StripeObject
+          # Numerical day between 1 and 31.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :day
+          # Numerical month between 1 and 12.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :month
+          # The four-digit year.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :year
+        end
+        class Error < Stripe::StripeObject
+          # A short machine-readable string giving the reason for the verification failure.
+          sig { returns(T.nilable(String)) }
+          attr_reader :code
+          # A human-readable message giving the reason for the failure. These messages can be shown to your users.
+          sig { returns(T.nilable(String)) }
+          attr_reader :reason
+        end
+        # Date of birth.
+        sig { returns(T.nilable(Dob)) }
+        attr_reader :dob
+        # Details on the verification error. Present when status is `unverified`.
+        sig { returns(T.nilable(Error)) }
+        attr_reader :error
+        # First name.
+        sig { returns(T.nilable(String)) }
+        attr_reader :first_name
+        # ID number. When `id_number_type` is `us_ssn`, only the last 4 digits are present.
+        sig { returns(T.nilable(String)) }
+        attr_reader :id_number
+        # Type of ID number.
+        sig { returns(T.nilable(String)) }
+        attr_reader :id_number_type
+        # Last name.
+        sig { returns(T.nilable(String)) }
+        attr_reader :last_name
+        # Status of this `id_number` check.
+        sig { returns(String) }
+        attr_reader :status
+      end
+      class Options < Stripe::StripeObject
+        class Document < Stripe::StripeObject
+          # Array of strings of allowed identity document types. If the provided identity document isn’t one of the allowed types, the verification check will fail with a document_type_not_allowed error code.
+          sig { returns(T::Array[String]) }
+          attr_reader :allowed_types
+          # Collect an ID number and perform an [ID number check](https://stripe.com/docs/identity/verification-checks?type=id-number) with the document’s extracted name and date of birth.
+          sig { returns(T::Boolean) }
+          attr_reader :require_id_number
+          # Disable image uploads, identity document images have to be captured using the device’s camera.
+          sig { returns(T::Boolean) }
+          attr_reader :require_live_capture
+          # Capture a face image and perform a [selfie check](https://stripe.com/docs/identity/verification-checks?type=selfie) comparing a photo ID and a picture of your user’s face. [Learn more](https://stripe.com/docs/identity/selfie).
+          sig { returns(T::Boolean) }
+          attr_reader :require_matching_selfie
+        end
+        class IdNumber < Stripe::StripeObject; end
+        # Attribute for field document
+        sig { returns(Document) }
+        attr_reader :document
+        # Attribute for field id_number
+        sig { returns(IdNumber) }
+        attr_reader :id_number
+      end
+      class Phone < Stripe::StripeObject
+        class Error < Stripe::StripeObject
+          # A short machine-readable string giving the reason for the verification failure.
+          sig { returns(T.nilable(String)) }
+          attr_reader :code
+          # A human-readable message giving the reason for the failure. These messages can be shown to your users.
+          sig { returns(T.nilable(String)) }
+          attr_reader :reason
+        end
+        # Details on the verification error. Present when status is `unverified`.
+        sig { returns(T.nilable(Error)) }
+        attr_reader :error
+        # Phone to be verified.
+        sig { returns(T.nilable(String)) }
+        attr_reader :phone
+        # Status of this `phone` check.
+        sig { returns(String) }
+        attr_reader :status
+      end
+      class Selfie < Stripe::StripeObject
+        class Error < Stripe::StripeObject
+          # A short machine-readable string giving the reason for the verification failure.
+          sig { returns(T.nilable(String)) }
+          attr_reader :code
+          # A human-readable message giving the reason for the failure. These messages can be shown to your users.
+          sig { returns(T.nilable(String)) }
+          attr_reader :reason
+        end
+        # ID of the [File](https://stripe.com/docs/api/files) holding the image of the identity document used in this check.
+        sig { returns(T.nilable(String)) }
+        attr_reader :document
+        # Details on the verification error. Present when status is `unverified`.
+        sig { returns(T.nilable(Error)) }
+        attr_reader :error
+        # ID of the [File](https://stripe.com/docs/api/files) holding the image of the selfie used in this check.
+        sig { returns(T.nilable(String)) }
+        attr_reader :selfie
+        # Status of this `selfie` check.
+        sig { returns(String) }
+        attr_reader :status
+      end
+      # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
+      sig { returns(T.nilable(String)) }
+      attr_reader :client_reference_id
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :created
+      # Result from a document check
+      sig { returns(Document) }
+      attr_reader :document
+      # Result from a email check
+      sig { returns(Email) }
+      attr_reader :email
+      # Unique identifier for the object.
+      sig { returns(String) }
+      attr_reader :id
+      # Result from an id_number check
+      sig { returns(IdNumber) }
+      attr_reader :id_number
+      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      sig { returns(T::Boolean) }
+      attr_reader :livemode
+      # String representing the object's type. Objects of the same type share the same value.
+      sig { returns(String) }
+      attr_reader :object
+      # Attribute for field options
+      sig { returns(Options) }
+      attr_reader :options
+      # Result from a phone check
+      sig { returns(Phone) }
+      attr_reader :phone
+      # Result from a selfie check
+      sig { returns(Selfie) }
+      attr_reader :selfie
+      # Type of report.
+      sig { returns(String) }
+      attr_reader :type
+      # The configuration token of a verification flow from the dashboard.
+      sig { returns(String) }
+      attr_reader :verification_flow
+      # ID of the VerificationSession that created this report.
+      sig { returns(T.nilable(String)) }
+      attr_reader :verification_session
+      class ListParams < Stripe::RequestParams
+        class Created < Stripe::RequestParams
+          # Minimum value to filter by (exclusive)
+          sig { returns(Integer) }
+          attr_accessor :gt
+          # Minimum value to filter by (inclusive)
+          sig { returns(Integer) }
+          attr_accessor :gte
+          # Maximum value to filter by (exclusive)
+          sig { returns(Integer) }
+          attr_accessor :lt
+          # Maximum value to filter by (inclusive)
+          sig { returns(Integer) }
+          attr_accessor :lte
+          sig { params(gt: Integer, gte: Integer, lt: Integer, lte: Integer).void }
+          def initialize(gt: nil, gte: nil, lt: nil, lte: nil); end
+        end
+        # A string to reference this user. This can be a customer ID, a session ID, or similar, and can be used to reconcile this verification with your internal systems.
+        sig { returns(String) }
+        attr_accessor :client_reference_id
+        # Only return VerificationReports that were created during the given date interval.
+        sig { returns(T.any(::Stripe::Identity::VerificationReport::ListParams::Created, Integer)) }
+        attr_accessor :created
+        # 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.
+        sig { returns(String) }
+        attr_accessor :ending_before
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        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.
+        sig { returns(Integer) }
+        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.
+        sig { returns(String) }
+        attr_accessor :starting_after
+        # Only return VerificationReports of this type
+        sig { returns(String) }
+        attr_accessor :type
+        # Only return VerificationReports created by this VerificationSession ID. It is allowed to provide a VerificationIntent ID.
+        sig { returns(String) }
+        attr_accessor :verification_session
+        sig {
+          params(client_reference_id: String, created: T.any(::Stripe::Identity::VerificationReport::ListParams::Created, Integer), ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String, type: String, verification_session: String).void
+         }
+        def initialize(
+          client_reference_id: nil,
+          created: nil,
+          ending_before: nil,
+          expand: nil,
+          limit: nil,
+          starting_after: nil,
+          type: nil,
+          verification_session: nil
+        ); end
+      end
+      class RetrieveParams < Stripe::RequestParams
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        sig { params(expand: T::Array[String]).void }
+        def initialize(expand: nil); end
+      end
+      # List all verification reports.
+      sig {
+        params(params: T.any(::Stripe::Identity::VerificationReport::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+    end
+  end
+end