stripe 13.4.0 → 13.5.0.pre.beta.1

data/rbi/stripe/resources/funding_instructions.rbi

@@ -0,0 +1,437 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  # Each customer has a [`balance`](https://stripe.com/docs/api/customers/object#customer_object-balance) that is
+  # automatically applied to future invoices and payments using the `customer_balance` payment method.
+  # Customers can fund this balance by initiating a bank transfer to any account in the
+  # `financial_addresses` field.
+  # Related guide: [Customer balance funding instructions](https://stripe.com/docs/payments/customer-balance/funding-instructions)
+  class FundingInstructions < APIResource
+    class BankTransfer < Stripe::StripeObject
+      class FinancialAddress < Stripe::StripeObject
+        class Aba < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The account holder name
+          sig { returns(String) }
+          attr_reader :account_holder_name
+          # The ABA account number
+          sig { returns(String) }
+          attr_reader :account_number
+          # The account type
+          sig { returns(String) }
+          attr_reader :account_type
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The bank name
+          sig { returns(String) }
+          attr_reader :bank_name
+          # The ABA routing number
+          sig { returns(String) }
+          attr_reader :routing_number
+        end
+        class Iban < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The name of the person or business that owns the bank account
+          sig { returns(String) }
+          attr_reader :account_holder_name
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The BIC/SWIFT code of the account.
+          sig { returns(String) }
+          attr_reader :bic
+          # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+          sig { returns(String) }
+          attr_reader :country
+          # The IBAN of the account.
+          sig { returns(String) }
+          attr_reader :iban
+        end
+        class SortCode < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The name of the person or business that owns the bank account
+          sig { returns(String) }
+          attr_reader :account_holder_name
+          # The account number
+          sig { returns(String) }
+          attr_reader :account_number
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The six-digit sort code
+          sig { returns(String) }
+          attr_reader :sort_code
+        end
+        class Spei < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The account holder name
+          sig { returns(String) }
+          attr_reader :account_holder_name
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The three-digit bank code
+          sig { returns(String) }
+          attr_reader :bank_code
+          # The short banking institution name
+          sig { returns(String) }
+          attr_reader :bank_name
+          # The CLABE number
+          sig { returns(String) }
+          attr_reader :clabe
+        end
+        class Swift < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The account holder name
+          sig { returns(String) }
+          attr_reader :account_holder_name
+          # The account number
+          sig { returns(String) }
+          attr_reader :account_number
+          # The account type
+          sig { returns(String) }
+          attr_reader :account_type
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The bank name
+          sig { returns(String) }
+          attr_reader :bank_name
+          # The SWIFT code
+          sig { returns(String) }
+          attr_reader :swift_code
+        end
+        class Zengin < Stripe::StripeObject
+          class AccountHolderAddress < 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 BankAddress < 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
+          # Attribute for field account_holder_address
+          sig { returns(AccountHolderAddress) }
+          attr_reader :account_holder_address
+          # The account holder name
+          sig { returns(T.nilable(String)) }
+          attr_reader :account_holder_name
+          # The account number
+          sig { returns(T.nilable(String)) }
+          attr_reader :account_number
+          # The bank account type. In Japan, this can only be `futsu` or `toza`.
+          sig { returns(T.nilable(String)) }
+          attr_reader :account_type
+          # Attribute for field bank_address
+          sig { returns(BankAddress) }
+          attr_reader :bank_address
+          # The bank code of the account
+          sig { returns(T.nilable(String)) }
+          attr_reader :bank_code
+          # The bank name of the account
+          sig { returns(T.nilable(String)) }
+          attr_reader :bank_name
+          # The branch code of the account
+          sig { returns(T.nilable(String)) }
+          attr_reader :branch_code
+          # The branch name of the account
+          sig { returns(T.nilable(String)) }
+          attr_reader :branch_name
+        end
+        # ABA Records contain U.S. bank account details per the ABA format.
+        sig { returns(Aba) }
+        attr_reader :aba
+        # Iban Records contain E.U. bank account details per the SEPA format.
+        sig { returns(Iban) }
+        attr_reader :iban
+        # Sort Code Records contain U.K. bank account details per the sort code format.
+        sig { returns(SortCode) }
+        attr_reader :sort_code
+        # SPEI Records contain Mexico bank account details per the SPEI format.
+        sig { returns(Spei) }
+        attr_reader :spei
+        # The payment networks supported by this FinancialAddress
+        sig { returns(T::Array[String]) }
+        attr_reader :supported_networks
+        # SWIFT Records contain U.S. bank account details per the SWIFT format.
+        sig { returns(Swift) }
+        attr_reader :swift
+        # The type of financial address
+        sig { returns(String) }
+        attr_reader :type
+        # Zengin Records contain Japan bank account details per the Zengin format.
+        sig { returns(Zengin) }
+        attr_reader :zengin
+      end
+      # The country of the bank account to fund
+      sig { returns(String) }
+      attr_reader :country
+      # A list of financial addresses that can be used to fund a particular balance
+      sig { returns(T::Array[FinancialAddress]) }
+      attr_reader :financial_addresses
+      # The bank_transfer type
+      sig { returns(String) }
+      attr_reader :type
+    end
+    # Attribute for field bank_transfer
+    sig { returns(BankTransfer) }
+    attr_reader :bank_transfer
+    # 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(String) }
+    attr_reader :currency
+    # The `funding_type` of the returned instructions
+    sig { returns(String) }
+    attr_reader :funding_type
+    # 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
+  end
+end

data/rbi/stripe/resources/gift_cards/card.rbi

@@ -0,0 +1,206 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+# typed: true
+module Stripe
+  module GiftCards
+    # A gift card represents a single gift card owned by a customer, including the
+    # remaining balance, gift card code, and whether or not it is active.
+    class Card < 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
+      # Whether this gift card can be used or not.
+      sig { returns(T::Boolean) }
+      attr_reader :active
+      # The amount of funds available for new transactions.
+      sig { returns(Integer) }
+      attr_reader :amount_available
+      # The amount of funds marked as held.
+      sig { returns(Integer) }
+      attr_reader :amount_held
+      # Code used to redeem this gift card.
+      sig { returns(T.nilable(String)) }
+      attr_reader :code
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      sig { returns(Integer) }
+      attr_reader :created
+      # The related Stripe objects that created this gift card.
+      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(String) }
+      attr_reader :currency
+      # 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
+      # Transactions on this gift card.
+      sig { returns(Stripe::ListObject) }
+      attr_reader :transactions
+      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
+        # 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
+        sig {
+          params(ending_before: String, expand: T::Array[String], limit: Integer, starting_after: String).void
+         }
+        def initialize(ending_before: nil, expand: nil, limit: nil, starting_after: 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::Card::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::Card::CreateParams::CreatedBy::Payment, type: String).void
+           }
+          def initialize(payment: nil, type: nil); end
+        end
+        # The active state for the new gift card, defaults to false. The active state can be updated after creation.
+        sig { returns(T::Boolean) }
+        attr_accessor :active
+        # Related objects which created this gift card.
+        sig { returns(::Stripe::GiftCards::Card::CreateParams::CreatedBy) }
+        attr_accessor :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(String) }
+        attr_accessor :currency
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The initial amount to load onto the new gift card, defaults to 0.
+        sig { returns(Integer) }
+        attr_accessor :initial_amount
+        # 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
+        sig {
+          params(active: T::Boolean, created_by: ::Stripe::GiftCards::Card::CreateParams::CreatedBy, currency: String, expand: T::Array[String], initial_amount: Integer, metadata: T::Hash[String, String]).void
+         }
+        def initialize(
+          active: nil,
+          created_by: nil,
+          currency: nil,
+          expand: nil,
+          initial_amount: nil,
+          metadata: 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
+        # The new active state for the gift card.
+        sig { returns(T::Boolean) }
+        attr_accessor :active
+        # 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(active: T::Boolean, expand: T::Array[String], metadata: T.nilable(T::Hash[String, String])).void
+         }
+        def initialize(active: nil, expand: nil, metadata: nil); end
+      end
+      class ValidateParams < Stripe::RequestParams
+        # The gift card code to be validated.
+        sig { returns(String) }
+        attr_accessor :code
+        # Specifies which fields in the response should be expanded.
+        sig { returns(T::Array[String]) }
+        attr_accessor :expand
+        # The pin associated with the gift card. Not all gift cards have pins.
+        sig { returns(String) }
+        attr_accessor :giftcard_pin
+        sig { params(code: String, expand: T::Array[String], giftcard_pin: String).void }
+        def initialize(code: nil, expand: nil, giftcard_pin: nil); end
+      end
+      # Creates a new gift card object.
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Card::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Card)
+       }
+      def self.create(params = {}, opts = {}); end
+
+      # List gift cards for an account
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Card::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
+       }
+      def self.list(params = {}, opts = {}); end
+
+      # Update a gift card
+      sig {
+        params(id: String, params: T.any(::Stripe::GiftCards::Card::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Card)
+       }
+      def self.update(id, params = {}, opts = {}); end
+
+      # Validates a gift card code, returning the matching gift card object if it exists.
+      sig {
+        params(params: T.any(::Stripe::GiftCards::Card::ValidateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::GiftCards::Card)
+       }
+      def self.validate(params = {}, opts = {}); end
+    end
+  end
+end