stripe 15.3.0 → 15.4.0.pre.beta.1

data/rbi/stripe/services/payment_method_service.rbi

@@ -1,781 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-# typed: true
-module Stripe
-  class PaymentMethodService < StripeService
-    class ListParams < Stripe::RequestParams
-      # The ID of the customer whose PaymentMethods will be retrieved.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :customer
-      # 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(T.nilable(String)) }
-      attr_accessor :ending_before
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(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(T.nilable(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(T.nilable(String)) }
-      attr_accessor :starting_after
-      # An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future payment method types. If your integration expects only one type of payment method in the response, make sure to provide a type value in the request.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :type
-      sig {
-        params(customer: T.nilable(String), ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), starting_after: T.nilable(String), type: T.nilable(String)).void
-       }
-      def initialize(
-        customer: nil,
-        ending_before: nil,
-        expand: nil,
-        limit: nil,
-        starting_after: nil,
-        type: nil
-      ); end
-    end
-    class CreateParams < Stripe::RequestParams
-      class AcssDebit < Stripe::RequestParams
-        # Customer's bank account number.
-        sig { returns(String) }
-        attr_accessor :account_number
-        # Institution number of the customer's bank.
-        sig { returns(String) }
-        attr_accessor :institution_number
-        # Transit number of the customer's bank.
-        sig { returns(String) }
-        attr_accessor :transit_number
-        sig {
-          params(account_number: String, institution_number: String, transit_number: String).void
-         }
-        def initialize(account_number: nil, institution_number: nil, transit_number: nil); end
-      end
-      class Affirm < Stripe::RequestParams; end
-      class AfterpayClearpay < Stripe::RequestParams; end
-      class Alipay < Stripe::RequestParams; end
-      class Alma < Stripe::RequestParams; end
-      class AmazonPay < Stripe::RequestParams; end
-      class AuBecsDebit < Stripe::RequestParams
-        # The account number for the bank account.
-        sig { returns(String) }
-        attr_accessor :account_number
-        # Bank-State-Branch number of the bank account.
-        sig { returns(String) }
-        attr_accessor :bsb_number
-        sig { params(account_number: String, bsb_number: String).void }
-        def initialize(account_number: nil, bsb_number: nil); end
-      end
-      class BacsDebit < Stripe::RequestParams
-        # Account number of the bank account that the funds will be debited from.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_number
-        # Sort code of the bank account. (e.g., `10-20-30`)
-        sig { returns(T.nilable(String)) }
-        attr_accessor :sort_code
-        sig { params(account_number: T.nilable(String), sort_code: T.nilable(String)).void }
-        def initialize(account_number: nil, sort_code: nil); end
-      end
-      class Bancontact < Stripe::RequestParams; end
-      class Billie < Stripe::RequestParams; end
-      class BillingDetails < Stripe::RequestParams
-        class Address < Stripe::RequestParams
-          # City, district, suburb, town, or village.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :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_accessor :country
-          # Address line 1 (e.g., street, PO Box, or company name).
-          sig { returns(T.nilable(String)) }
-          attr_accessor :line1
-          # Address line 2 (e.g., apartment, suite, unit, or building).
-          sig { returns(T.nilable(String)) }
-          attr_accessor :line2
-          # ZIP or postal code.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :postal_code
-          # State, county, province, or region.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :state
-          sig {
-            params(city: T.nilable(String), country: T.nilable(String), line1: T.nilable(String), line2: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String)).void
-           }
-          def initialize(
-            city: nil,
-            country: nil,
-            line1: nil,
-            line2: nil,
-            postal_code: nil,
-            state: nil
-          ); end
-        end
-        # Billing address.
-        sig {
-          returns(T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::CreateParams::BillingDetails::Address))))
-         }
-        attr_accessor :address
-        # Email address.
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :email
-        # Full name.
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :name
-        # Billing phone number (including extension).
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :phone
-        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :tax_id
-        sig {
-          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::CreateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String)), tax_id: T.nilable(String)).void
-         }
-        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil); end
-      end
-      class Blik < Stripe::RequestParams; end
-      class Boleto < Stripe::RequestParams
-        # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
-        sig { returns(String) }
-        attr_accessor :tax_id
-        sig { params(tax_id: String).void }
-        def initialize(tax_id: nil); end
-      end
-      class Card < Stripe::RequestParams
-        class Networks < Stripe::RequestParams
-          # The customer's preferred card network for co-branded cards. Supports `cartes_bancaires`, `mastercard`, or `visa`. Selection of a network that does not apply to the card will be stored as `invalid_preference` on the card.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :preferred
-          sig { params(preferred: T.nilable(String)).void }
-          def initialize(preferred: nil); end
-        end
-        # The card's CVC. It is highly recommended to always include this value.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :cvc
-        # Two-digit number representing the card's expiration month.
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :exp_month
-        # Four-digit number representing the card's expiration year.
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :exp_year
-        # Contains information about card networks used to process the payment.
-        sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Card::Networks)) }
-        attr_accessor :networks
-        # The card number, as a string without any separators.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :number
-        # For backwards compatibility, you can alternatively provide a Stripe token (e.g., for Apple Pay, Amex Express Checkout, or legacy Checkout) into the card hash with format card: {token: "tok_visa"}.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :token
-        sig {
-          params(cvc: T.nilable(String), exp_month: T.nilable(Integer), exp_year: T.nilable(Integer), networks: T.nilable(::Stripe::PaymentMethodService::CreateParams::Card::Networks), number: T.nilable(String), token: T.nilable(String)).void
-         }
-        def initialize(
-          cvc: nil,
-          exp_month: nil,
-          exp_year: nil,
-          networks: nil,
-          number: nil,
-          token: nil
-        ); end
-      end
-      class Cashapp < Stripe::RequestParams; end
-      class Crypto < Stripe::RequestParams; end
-      class CustomerBalance < Stripe::RequestParams; end
-      class Eps < Stripe::RequestParams
-        # The customer's bank.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :bank
-        sig { params(bank: T.nilable(String)).void }
-        def initialize(bank: nil); end
-      end
-      class Fpx < Stripe::RequestParams
-        # Account holder type for FPX transaction
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_holder_type
-        # The customer's bank.
-        sig { returns(String) }
-        attr_accessor :bank
-        sig { params(account_holder_type: T.nilable(String), bank: String).void }
-        def initialize(account_holder_type: nil, bank: nil); end
-      end
-      class Giropay < Stripe::RequestParams; end
-      class Grabpay < Stripe::RequestParams; end
-      class Ideal < Stripe::RequestParams
-        # The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :bank
-        sig { params(bank: T.nilable(String)).void }
-        def initialize(bank: nil); end
-      end
-      class InteracPresent < Stripe::RequestParams; end
-      class KakaoPay < Stripe::RequestParams; end
-      class Klarna < Stripe::RequestParams
-        class Dob < Stripe::RequestParams
-          # The day of birth, between 1 and 31.
-          sig { returns(Integer) }
-          attr_accessor :day
-          # The month of birth, between 1 and 12.
-          sig { returns(Integer) }
-          attr_accessor :month
-          # The four-digit year of birth.
-          sig { returns(Integer) }
-          attr_accessor :year
-          sig { params(day: Integer, month: Integer, year: Integer).void }
-          def initialize(day: nil, month: nil, year: nil); end
-        end
-        # Customer's date of birth
-        sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna::Dob)) }
-        attr_accessor :dob
-        sig {
-          params(dob: T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna::Dob)).void
-         }
-        def initialize(dob: nil); end
-      end
-      class Konbini < Stripe::RequestParams; end
-      class KrCard < Stripe::RequestParams; end
-      class Link < Stripe::RequestParams; end
-      class Mobilepay < Stripe::RequestParams; end
-      class Multibanco < Stripe::RequestParams; end
-      class NaverPay < Stripe::RequestParams
-        # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :funding
-        sig { params(funding: T.nilable(String)).void }
-        def initialize(funding: nil); end
-      end
-      class NzBankAccount < Stripe::RequestParams
-        # The name on the bank account. Only required if the account holder name is different from the name of the authorized signatory collected in the PaymentMethod’s billing details.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_holder_name
-        # The account number for the bank account.
-        sig { returns(String) }
-        attr_accessor :account_number
-        # The numeric code for the bank account's bank.
-        sig { returns(String) }
-        attr_accessor :bank_code
-        # The numeric code for the bank account's bank branch.
-        sig { returns(String) }
-        attr_accessor :branch_code
-        # Attribute for param field reference
-        sig { returns(T.nilable(String)) }
-        attr_accessor :reference
-        # The suffix of the bank account number.
-        sig { returns(String) }
-        attr_accessor :suffix
-        sig {
-          params(account_holder_name: T.nilable(String), account_number: String, bank_code: String, branch_code: String, reference: T.nilable(String), suffix: String).void
-         }
-        def initialize(
-          account_holder_name: nil,
-          account_number: nil,
-          bank_code: nil,
-          branch_code: nil,
-          reference: nil,
-          suffix: nil
-        ); end
-      end
-      class Oxxo < Stripe::RequestParams; end
-      class P24 < Stripe::RequestParams
-        # The customer's bank.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :bank
-        sig { params(bank: T.nilable(String)).void }
-        def initialize(bank: nil); end
-      end
-      class PayByBank < Stripe::RequestParams; end
-      class Payco < Stripe::RequestParams; end
-      class Paynow < Stripe::RequestParams; end
-      class Paypal < Stripe::RequestParams; end
-      class Pix < Stripe::RequestParams; end
-      class Promptpay < Stripe::RequestParams; end
-      class RadarOptions < Stripe::RequestParams
-        # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :session
-        sig { params(session: T.nilable(String)).void }
-        def initialize(session: nil); end
-      end
-      class RevolutPay < Stripe::RequestParams; end
-      class SamsungPay < Stripe::RequestParams; end
-      class Satispay < Stripe::RequestParams; end
-      class SepaDebit < Stripe::RequestParams
-        # IBAN of the bank account.
-        sig { returns(String) }
-        attr_accessor :iban
-        sig { params(iban: String).void }
-        def initialize(iban: nil); end
-      end
-      class Sofort < Stripe::RequestParams
-        # Two-letter ISO code representing the country the bank account is located in.
-        sig { returns(String) }
-        attr_accessor :country
-        sig { params(country: String).void }
-        def initialize(country: nil); end
-      end
-      class Swish < Stripe::RequestParams; end
-      class Twint < Stripe::RequestParams; end
-      class UsBankAccount < Stripe::RequestParams
-        # Account holder type: individual or company.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_holder_type
-        # Account number of the bank account.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_number
-        # Account type: checkings or savings. Defaults to checking if omitted.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_type
-        # The ID of a Financial Connections Account to use as a payment method.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :financial_connections_account
-        # Routing number of the bank account.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :routing_number
-        sig {
-          params(account_holder_type: T.nilable(String), account_number: T.nilable(String), account_type: T.nilable(String), financial_connections_account: T.nilable(String), routing_number: T.nilable(String)).void
-         }
-        def initialize(
-          account_holder_type: nil,
-          account_number: nil,
-          account_type: nil,
-          financial_connections_account: nil,
-          routing_number: nil
-        ); end
-      end
-      class WechatPay < Stripe::RequestParams; end
-      class Zip < Stripe::RequestParams; end
-      # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::AcssDebit)) }
-      attr_accessor :acss_debit
-      # If this is an `affirm` PaymentMethod, this hash contains details about the Affirm payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Affirm)) }
-      attr_accessor :affirm
-      # If this is an `AfterpayClearpay` PaymentMethod, this hash contains details about the AfterpayClearpay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::AfterpayClearpay)) }
-      attr_accessor :afterpay_clearpay
-      # If this is an `Alipay` PaymentMethod, this hash contains details about the Alipay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Alipay)) }
-      attr_accessor :alipay
-      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to `unspecified`.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :allow_redisplay
-      # If this is a Alma PaymentMethod, this hash contains details about the Alma payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Alma)) }
-      attr_accessor :alma
-      # If this is a AmazonPay PaymentMethod, this hash contains details about the AmazonPay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::AmazonPay)) }
-      attr_accessor :amazon_pay
-      # If this is an `au_becs_debit` PaymentMethod, this hash contains details about the bank account.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::AuBecsDebit)) }
-      attr_accessor :au_becs_debit
-      # If this is a `bacs_debit` PaymentMethod, this hash contains details about the Bacs Direct Debit bank account.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::BacsDebit)) }
-      attr_accessor :bacs_debit
-      # If this is a `bancontact` PaymentMethod, this hash contains details about the Bancontact payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Bancontact)) }
-      attr_accessor :bancontact
-      # If this is a `billie` PaymentMethod, this hash contains details about the Billie payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Billie)) }
-      attr_accessor :billie
-      # Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::BillingDetails)) }
-      attr_accessor :billing_details
-      # If this is a `blik` PaymentMethod, this hash contains details about the BLIK payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Blik)) }
-      attr_accessor :blik
-      # If this is a `boleto` PaymentMethod, this hash contains details about the Boleto payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Boleto)) }
-      attr_accessor :boleto
-      # If this is a `card` PaymentMethod, this hash contains the user's card details. For backwards compatibility, you can alternatively provide a Stripe token (e.g., for Apple Pay, Amex Express Checkout, or legacy Checkout) into the card hash with format `card: {token: "tok_visa"}`. When providing a card number, you must meet the requirements for [PCI compliance](https://stripe.com/docs/security#validating-pci-compliance). We strongly recommend using Stripe.js instead of interacting with this API directly.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Card)) }
-      attr_accessor :card
-      # If this is a `cashapp` PaymentMethod, this hash contains details about the Cash App Pay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Cashapp)) }
-      attr_accessor :cashapp
-      # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Crypto)) }
-      attr_accessor :crypto
-      # The `Customer` to whom the original PaymentMethod is attached.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :customer
-      # If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::CustomerBalance)) }
-      attr_accessor :customer_balance
-      # If this is an `eps` PaymentMethod, this hash contains details about the EPS payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Eps)) }
-      attr_accessor :eps
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_accessor :expand
-      # If this is an `fpx` PaymentMethod, this hash contains details about the FPX payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Fpx)) }
-      attr_accessor :fpx
-      # If this is a `giropay` PaymentMethod, this hash contains details about the Giropay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Giropay)) }
-      attr_accessor :giropay
-      # If this is a `grabpay` PaymentMethod, this hash contains details about the GrabPay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Grabpay)) }
-      attr_accessor :grabpay
-      # If this is an `ideal` PaymentMethod, this hash contains details about the iDEAL payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Ideal)) }
-      attr_accessor :ideal
-      # If this is an `interac_present` PaymentMethod, this hash contains details about the Interac Present payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::InteracPresent)) }
-      attr_accessor :interac_present
-      # If this is a `kakao_pay` PaymentMethod, this hash contains details about the Kakao Pay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::KakaoPay)) }
-      attr_accessor :kakao_pay
-      # If this is a `klarna` PaymentMethod, this hash contains details about the Klarna payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna)) }
-      attr_accessor :klarna
-      # If this is a `konbini` PaymentMethod, this hash contains details about the Konbini payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Konbini)) }
-      attr_accessor :konbini
-      # If this is a `kr_card` PaymentMethod, this hash contains details about the Korean Card payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::KrCard)) }
-      attr_accessor :kr_card
-      # If this is an `Link` PaymentMethod, this hash contains details about the Link payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Link)) }
-      attr_accessor :link
-      # 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
-      # If this is a `mobilepay` PaymentMethod, this hash contains details about the MobilePay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Mobilepay)) }
-      attr_accessor :mobilepay
-      # If this is a `multibanco` PaymentMethod, this hash contains details about the Multibanco payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Multibanco)) }
-      attr_accessor :multibanco
-      # If this is a `naver_pay` PaymentMethod, this hash contains details about the Naver Pay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::NaverPay)) }
-      attr_accessor :naver_pay
-      # If this is an nz_bank_account PaymentMethod, this hash contains details about the nz_bank_account payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::NzBankAccount)) }
-      attr_accessor :nz_bank_account
-      # If this is an `oxxo` PaymentMethod, this hash contains details about the OXXO payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Oxxo)) }
-      attr_accessor :oxxo
-      # If this is a `p24` PaymentMethod, this hash contains details about the P24 payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::P24)) }
-      attr_accessor :p24
-      # If this is a `pay_by_bank` PaymentMethod, this hash contains details about the PayByBank payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::PayByBank)) }
-      attr_accessor :pay_by_bank
-      # If this is a `payco` PaymentMethod, this hash contains details about the PAYCO payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Payco)) }
-      attr_accessor :payco
-      # The PaymentMethod to share.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :payment_method
-      # If this is a `paynow` PaymentMethod, this hash contains details about the PayNow payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Paynow)) }
-      attr_accessor :paynow
-      # If this is a `paypal` PaymentMethod, this hash contains details about the PayPal payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Paypal)) }
-      attr_accessor :paypal
-      # If this is a `pix` PaymentMethod, this hash contains details about the Pix payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Pix)) }
-      attr_accessor :pix
-      # If this is a `promptpay` PaymentMethod, this hash contains details about the PromptPay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Promptpay)) }
-      attr_accessor :promptpay
-      # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::RadarOptions)) }
-      attr_accessor :radar_options
-      # If this is a `revolut_pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::RevolutPay)) }
-      attr_accessor :revolut_pay
-      # If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::SamsungPay)) }
-      attr_accessor :samsung_pay
-      # If this is a `satispay` PaymentMethod, this hash contains details about the Satispay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Satispay)) }
-      attr_accessor :satispay
-      # If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::SepaDebit)) }
-      attr_accessor :sepa_debit
-      # If this is a `sofort` PaymentMethod, this hash contains details about the SOFORT payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Sofort)) }
-      attr_accessor :sofort
-      # If this is a `swish` PaymentMethod, this hash contains details about the Swish payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Swish)) }
-      attr_accessor :swish
-      # If this is a TWINT PaymentMethod, this hash contains details about the TWINT payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Twint)) }
-      attr_accessor :twint
-      # The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :type
-      # If this is an `us_bank_account` PaymentMethod, this hash contains details about the US bank account payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::UsBankAccount)) }
-      attr_accessor :us_bank_account
-      # If this is an `wechat_pay` PaymentMethod, this hash contains details about the wechat_pay payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::WechatPay)) }
-      attr_accessor :wechat_pay
-      # If this is a `zip` PaymentMethod, this hash contains details about the Zip payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::CreateParams::Zip)) }
-      attr_accessor :zip
-      sig {
-        params(acss_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AcssDebit), affirm: T.nilable(::Stripe::PaymentMethodService::CreateParams::Affirm), afterpay_clearpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AfterpayClearpay), alipay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alipay), allow_redisplay: T.nilable(String), alma: T.nilable(::Stripe::PaymentMethodService::CreateParams::Alma), amazon_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::AmazonPay), au_becs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::AuBecsDebit), bacs_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::BacsDebit), bancontact: T.nilable(::Stripe::PaymentMethodService::CreateParams::Bancontact), billie: T.nilable(::Stripe::PaymentMethodService::CreateParams::Billie), billing_details: T.nilable(::Stripe::PaymentMethodService::CreateParams::BillingDetails), blik: T.nilable(::Stripe::PaymentMethodService::CreateParams::Blik), boleto: T.nilable(::Stripe::PaymentMethodService::CreateParams::Boleto), card: T.nilable(::Stripe::PaymentMethodService::CreateParams::Card), cashapp: T.nilable(::Stripe::PaymentMethodService::CreateParams::Cashapp), crypto: T.nilable(::Stripe::PaymentMethodService::CreateParams::Crypto), customer: T.nilable(String), customer_balance: T.nilable(::Stripe::PaymentMethodService::CreateParams::CustomerBalance), eps: T.nilable(::Stripe::PaymentMethodService::CreateParams::Eps), expand: T.nilable(T::Array[String]), fpx: T.nilable(::Stripe::PaymentMethodService::CreateParams::Fpx), giropay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Giropay), grabpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Grabpay), ideal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Ideal), interac_present: T.nilable(::Stripe::PaymentMethodService::CreateParams::InteracPresent), kakao_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::KakaoPay), klarna: T.nilable(::Stripe::PaymentMethodService::CreateParams::Klarna), konbini: T.nilable(::Stripe::PaymentMethodService::CreateParams::Konbini), kr_card: T.nilable(::Stripe::PaymentMethodService::CreateParams::KrCard), link: T.nilable(::Stripe::PaymentMethodService::CreateParams::Link), metadata: T.nilable(T::Hash[String, String]), mobilepay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Mobilepay), multibanco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Multibanco), naver_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::NaverPay), nz_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::NzBankAccount), oxxo: T.nilable(::Stripe::PaymentMethodService::CreateParams::Oxxo), p24: T.nilable(::Stripe::PaymentMethodService::CreateParams::P24), pay_by_bank: T.nilable(::Stripe::PaymentMethodService::CreateParams::PayByBank), payco: T.nilable(::Stripe::PaymentMethodService::CreateParams::Payco), payment_method: T.nilable(String), paynow: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paynow), paypal: T.nilable(::Stripe::PaymentMethodService::CreateParams::Paypal), pix: T.nilable(::Stripe::PaymentMethodService::CreateParams::Pix), promptpay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Promptpay), radar_options: T.nilable(::Stripe::PaymentMethodService::CreateParams::RadarOptions), revolut_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::RevolutPay), samsung_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::SamsungPay), satispay: T.nilable(::Stripe::PaymentMethodService::CreateParams::Satispay), sepa_debit: T.nilable(::Stripe::PaymentMethodService::CreateParams::SepaDebit), sofort: T.nilable(::Stripe::PaymentMethodService::CreateParams::Sofort), swish: T.nilable(::Stripe::PaymentMethodService::CreateParams::Swish), twint: T.nilable(::Stripe::PaymentMethodService::CreateParams::Twint), type: T.nilable(String), us_bank_account: T.nilable(::Stripe::PaymentMethodService::CreateParams::UsBankAccount), wechat_pay: T.nilable(::Stripe::PaymentMethodService::CreateParams::WechatPay), zip: T.nilable(::Stripe::PaymentMethodService::CreateParams::Zip)).void
-       }
-      def initialize(
-        acss_debit: nil,
-        affirm: nil,
-        afterpay_clearpay: nil,
-        alipay: nil,
-        allow_redisplay: nil,
-        alma: nil,
-        amazon_pay: nil,
-        au_becs_debit: nil,
-        bacs_debit: nil,
-        bancontact: nil,
-        billie: nil,
-        billing_details: nil,
-        blik: nil,
-        boleto: nil,
-        card: nil,
-        cashapp: nil,
-        crypto: nil,
-        customer: nil,
-        customer_balance: nil,
-        eps: nil,
-        expand: nil,
-        fpx: nil,
-        giropay: nil,
-        grabpay: nil,
-        ideal: nil,
-        interac_present: nil,
-        kakao_pay: nil,
-        klarna: nil,
-        konbini: nil,
-        kr_card: nil,
-        link: nil,
-        metadata: nil,
-        mobilepay: nil,
-        multibanco: nil,
-        naver_pay: nil,
-        nz_bank_account: nil,
-        oxxo: nil,
-        p24: nil,
-        pay_by_bank: nil,
-        payco: nil,
-        payment_method: nil,
-        paynow: nil,
-        paypal: nil,
-        pix: nil,
-        promptpay: nil,
-        radar_options: nil,
-        revolut_pay: nil,
-        samsung_pay: nil,
-        satispay: nil,
-        sepa_debit: nil,
-        sofort: nil,
-        swish: nil,
-        twint: nil,
-        type: nil,
-        us_bank_account: nil,
-        wechat_pay: nil,
-        zip: nil
-      ); end
-    end
-    class RetrieveParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_accessor :expand
-      sig { params(expand: T.nilable(T::Array[String])).void }
-      def initialize(expand: nil); end
-    end
-    class UpdateParams < Stripe::RequestParams
-      class BillingDetails < Stripe::RequestParams
-        class Address < Stripe::RequestParams
-          # City, district, suburb, town, or village.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :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_accessor :country
-          # Address line 1 (e.g., street, PO Box, or company name).
-          sig { returns(T.nilable(String)) }
-          attr_accessor :line1
-          # Address line 2 (e.g., apartment, suite, unit, or building).
-          sig { returns(T.nilable(String)) }
-          attr_accessor :line2
-          # ZIP or postal code.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :postal_code
-          # State, county, province, or region.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :state
-          sig {
-            params(city: T.nilable(String), country: T.nilable(String), line1: T.nilable(String), line2: T.nilable(String), postal_code: T.nilable(String), state: T.nilable(String)).void
-           }
-          def initialize(
-            city: nil,
-            country: nil,
-            line1: nil,
-            line2: nil,
-            postal_code: nil,
-            state: nil
-          ); end
-        end
-        # Billing address.
-        sig {
-          returns(T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::UpdateParams::BillingDetails::Address))))
-         }
-        attr_accessor :address
-        # Email address.
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :email
-        # Full name.
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :name
-        # Billing phone number (including extension).
-        sig { returns(T.nilable(T.nilable(String))) }
-        attr_accessor :phone
-        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :tax_id
-        sig {
-          params(address: T.nilable(T.nilable(T.any(String, ::Stripe::PaymentMethodService::UpdateParams::BillingDetails::Address))), email: T.nilable(T.nilable(String)), name: T.nilable(T.nilable(String)), phone: T.nilable(T.nilable(String)), tax_id: T.nilable(String)).void
-         }
-        def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil); end
-      end
-      class Card < Stripe::RequestParams
-        class Networks < Stripe::RequestParams
-          # The customer's preferred card network for co-branded cards. Supports `cartes_bancaires`, `mastercard`, or `visa`. Selection of a network that does not apply to the card will be stored as `invalid_preference` on the card.
-          sig { returns(T.nilable(T.nilable(T.any(String, String)))) }
-          attr_accessor :preferred
-          sig { params(preferred: T.nilable(T.nilable(T.any(String, String)))).void }
-          def initialize(preferred: nil); end
-        end
-        # Two-digit number representing the card's expiration month.
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :exp_month
-        # Four-digit number representing the card's expiration year.
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :exp_year
-        # Contains information about card networks used to process the payment.
-        sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::Card::Networks)) }
-        attr_accessor :networks
-        sig {
-          params(exp_month: T.nilable(Integer), exp_year: T.nilable(Integer), networks: T.nilable(::Stripe::PaymentMethodService::UpdateParams::Card::Networks)).void
-         }
-        def initialize(exp_month: nil, exp_year: nil, networks: nil); end
-      end
-      class Link < Stripe::RequestParams; end
-      class PayByBank < Stripe::RequestParams; end
-      class UsBankAccount < Stripe::RequestParams
-        # Bank account holder type.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_holder_type
-        # Bank account type.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :account_type
-        sig { params(account_holder_type: T.nilable(String), account_type: T.nilable(String)).void }
-        def initialize(account_holder_type: nil, account_type: nil); end
-      end
-      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to `unspecified`.
-      sig { returns(T.nilable(String)) }
-      attr_accessor :allow_redisplay
-      # Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::BillingDetails)) }
-      attr_accessor :billing_details
-      # If this is a `card` PaymentMethod, this hash contains the user's card details.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::Card)) }
-      attr_accessor :card
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_accessor :expand
-      # If this is an `Link` PaymentMethod, this hash contains details about the Link payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::Link)) }
-      attr_accessor :link
-      # 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.nilable(T.any(String, T::Hash[String, String])))) }
-      attr_accessor :metadata
-      # If this is a `pay_by_bank` PaymentMethod, this hash contains details about the PayByBank payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::PayByBank)) }
-      attr_accessor :pay_by_bank
-      # If this is an `us_bank_account` PaymentMethod, this hash contains details about the US bank account payment method.
-      sig { returns(T.nilable(::Stripe::PaymentMethodService::UpdateParams::UsBankAccount)) }
-      attr_accessor :us_bank_account
-      sig {
-        params(allow_redisplay: T.nilable(String), billing_details: T.nilable(::Stripe::PaymentMethodService::UpdateParams::BillingDetails), card: T.nilable(::Stripe::PaymentMethodService::UpdateParams::Card), expand: T.nilable(T::Array[String]), link: T.nilable(::Stripe::PaymentMethodService::UpdateParams::Link), metadata: T.nilable(T.nilable(T.any(String, T::Hash[String, String]))), pay_by_bank: T.nilable(::Stripe::PaymentMethodService::UpdateParams::PayByBank), us_bank_account: T.nilable(::Stripe::PaymentMethodService::UpdateParams::UsBankAccount)).void
-       }
-      def initialize(
-        allow_redisplay: nil,
-        billing_details: nil,
-        card: nil,
-        expand: nil,
-        link: nil,
-        metadata: nil,
-        pay_by_bank: nil,
-        us_bank_account: nil
-      ); end
-    end
-    class AttachParams < Stripe::RequestParams
-      # The ID of the customer to which to attach the PaymentMethod.
-      sig { returns(String) }
-      attr_accessor :customer
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_accessor :expand
-      sig { params(customer: String, expand: T.nilable(T::Array[String])).void }
-      def initialize(customer: nil, expand: nil); end
-    end
-    class DetachParams < Stripe::RequestParams
-      # Specifies which fields in the response should be expanded.
-      sig { returns(T.nilable(T::Array[String])) }
-      attr_accessor :expand
-      sig { params(expand: T.nilable(T::Array[String])).void }
-      def initialize(expand: nil); end
-    end
-    # Attaches a PaymentMethod object to a Customer.
-    #
-    # To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
-    # or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
-    # These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
-    # endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
-    # future use, which makes later declines and payment friction more likely.
-    # See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
-    # future payments.
-    #
-    # To use this PaymentMethod as the default for invoice or subscription payments,
-    # set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
-    # on the Customer to the PaymentMethod's ID.
-    sig {
-      params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::AttachParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
-     }
-    def attach(payment_method, params = {}, opts = {}); end
-
-    # Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
-    #
-    # Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
-    sig {
-      params(params: T.any(::Stripe::PaymentMethodService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
-     }
-    def create(params = {}, opts = {}); end
-
-    # Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no longer be used for a payment or re-attached to a Customer.
-    sig {
-      params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::DetachParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
-     }
-    def detach(payment_method, params = {}, opts = {}); end
-
-    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
-    sig {
-      params(params: T.any(::Stripe::PaymentMethodService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
-     }
-    def list(params = {}, opts = {}); end
-
-    # Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer)
-    sig {
-      params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
-     }
-    def retrieve(payment_method, params = {}, opts = {}); end
-
-    # Updates a PaymentMethod object. A PaymentMethod must be attached a customer to be updated.
-    sig {
-      params(payment_method: String, params: T.any(::Stripe::PaymentMethodService::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::PaymentMethod)
-     }
-    def update(payment_method, params = {}, opts = {}); end
-  end
-end