mirror of
https://github.com/stripe/stripe-ruby.git
synced 2025-10-05 00:02:50 -04:00
422 lines
23 KiB
Ruby
422 lines
23 KiB
Ruby
# File generated from our OpenAPI spec
|
||
# frozen_string_literal: true
|
||
|
||
# typed: true
|
||
module Stripe
|
||
class AccountExternalAccountService < StripeService
|
||
class DeleteParams < Stripe::RequestParams; end
|
||
class RetrieveParams < Stripe::RequestParams
|
||
# Specifies which fields in the response should be expanded.
|
||
sig { returns(T.nilable(T::Array[String])) }
|
||
def expand; end
|
||
sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
|
||
def expand=(_expand); end
|
||
sig { params(expand: T.nilable(T::Array[String])).void }
|
||
def initialize(expand: nil); end
|
||
end
|
||
class UpdateParams < Stripe::RequestParams
|
||
class Documents < Stripe::RequestParams
|
||
class BankAccountOwnershipVerification < Stripe::RequestParams
|
||
# One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
|
||
sig { returns(T.nilable(T::Array[String])) }
|
||
def files; end
|
||
sig { params(_files: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
|
||
def files=(_files); end
|
||
sig { params(files: T.nilable(T::Array[String])).void }
|
||
def initialize(files: nil); end
|
||
end
|
||
# One or more documents that support the [Bank account ownership verification](https://support.stripe.com/questions/bank-account-ownership-verification) requirement. Must be a document associated with the bank account that displays the last 4 digits of the account number, either a statement or a check.
|
||
sig {
|
||
returns(T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents::BankAccountOwnershipVerification))
|
||
}
|
||
def bank_account_ownership_verification; end
|
||
sig {
|
||
params(_bank_account_ownership_verification: T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents::BankAccountOwnershipVerification)).returns(T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents::BankAccountOwnershipVerification))
|
||
}
|
||
def bank_account_ownership_verification=(_bank_account_ownership_verification); end
|
||
sig {
|
||
params(bank_account_ownership_verification: T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents::BankAccountOwnershipVerification)).void
|
||
}
|
||
def initialize(bank_account_ownership_verification: nil); end
|
||
end
|
||
# The name of the person or business that owns the bank account.
|
||
sig { returns(T.nilable(String)) }
|
||
def account_holder_name; end
|
||
sig { params(_account_holder_name: T.nilable(String)).returns(T.nilable(String)) }
|
||
def account_holder_name=(_account_holder_name); end
|
||
# The type of entity that holds the account. This can be either `individual` or `company`.
|
||
sig { returns(T.nilable(T.any(String, String))) }
|
||
def account_holder_type; end
|
||
sig {
|
||
params(_account_holder_type: T.nilable(T.any(String, String))).returns(T.nilable(T.any(String, String)))
|
||
}
|
||
def account_holder_type=(_account_holder_type); end
|
||
# The bank account type. This can only be `checking` or `savings` in most countries. In Japan, this can only be `futsu` or `toza`.
|
||
sig { returns(T.nilable(String)) }
|
||
def account_type; end
|
||
sig { params(_account_type: T.nilable(String)).returns(T.nilable(String)) }
|
||
def account_type=(_account_type); end
|
||
# City/District/Suburb/Town/Village.
|
||
sig { returns(T.nilable(String)) }
|
||
def address_city; end
|
||
sig { params(_address_city: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_city=(_address_city); end
|
||
# Billing address country, if provided when creating card.
|
||
sig { returns(T.nilable(String)) }
|
||
def address_country; end
|
||
sig { params(_address_country: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_country=(_address_country); end
|
||
# Address line 1 (Street address/PO Box/Company name).
|
||
sig { returns(T.nilable(String)) }
|
||
def address_line1; end
|
||
sig { params(_address_line1: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_line1=(_address_line1); end
|
||
# Address line 2 (Apartment/Suite/Unit/Building).
|
||
sig { returns(T.nilable(String)) }
|
||
def address_line2; end
|
||
sig { params(_address_line2: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_line2=(_address_line2); end
|
||
# State/County/Province/Region.
|
||
sig { returns(T.nilable(String)) }
|
||
def address_state; end
|
||
sig { params(_address_state: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_state=(_address_state); end
|
||
# ZIP or postal code.
|
||
sig { returns(T.nilable(String)) }
|
||
def address_zip; end
|
||
sig { params(_address_zip: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_zip=(_address_zip); end
|
||
# When set to true, this becomes the default external account for its currency.
|
||
sig { returns(T.nilable(T::Boolean)) }
|
||
def default_for_currency; end
|
||
sig { params(_default_for_currency: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
|
||
def default_for_currency=(_default_for_currency); end
|
||
# Documents that may be submitted to satisfy various informational requests.
|
||
sig { returns(T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents)) }
|
||
def documents; end
|
||
sig {
|
||
params(_documents: T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents)).returns(T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents))
|
||
}
|
||
def documents=(_documents); end
|
||
# Two digit number representing the card’s expiration month.
|
||
sig { returns(T.nilable(String)) }
|
||
def exp_month; end
|
||
sig { params(_exp_month: T.nilable(String)).returns(T.nilable(String)) }
|
||
def exp_month=(_exp_month); end
|
||
# Four digit number representing the card’s expiration year.
|
||
sig { returns(T.nilable(String)) }
|
||
def exp_year; end
|
||
sig { params(_exp_year: T.nilable(String)).returns(T.nilable(String)) }
|
||
def exp_year=(_exp_year); end
|
||
# Specifies which fields in the response should be expanded.
|
||
sig { returns(T.nilable(T::Array[String])) }
|
||
def expand; end
|
||
sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
|
||
def expand=(_expand); end
|
||
# 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.any(String, T::Hash[String, String]))) }
|
||
def metadata; end
|
||
sig {
|
||
params(_metadata: T.nilable(T.any(String, T::Hash[String, String]))).returns(T.nilable(T.any(String, T::Hash[String, String])))
|
||
}
|
||
def metadata=(_metadata); end
|
||
# Cardholder name.
|
||
sig { returns(T.nilable(String)) }
|
||
def name; end
|
||
sig { params(_name: T.nilable(String)).returns(T.nilable(String)) }
|
||
def name=(_name); end
|
||
sig {
|
||
params(account_holder_name: T.nilable(String), account_holder_type: T.nilable(T.any(String, String)), account_type: T.nilable(String), address_city: T.nilable(String), address_country: T.nilable(String), address_line1: T.nilable(String), address_line2: T.nilable(String), address_state: T.nilable(String), address_zip: T.nilable(String), default_for_currency: T.nilable(T::Boolean), documents: T.nilable(::Stripe::AccountExternalAccountService::UpdateParams::Documents), exp_month: T.nilable(String), exp_year: T.nilable(String), expand: T.nilable(T::Array[String]), metadata: T.nilable(T.any(String, T::Hash[String, String])), name: T.nilable(String)).void
|
||
}
|
||
def initialize(
|
||
account_holder_name: nil,
|
||
account_holder_type: nil,
|
||
account_type: nil,
|
||
address_city: nil,
|
||
address_country: nil,
|
||
address_line1: nil,
|
||
address_line2: nil,
|
||
address_state: nil,
|
||
address_zip: nil,
|
||
default_for_currency: nil,
|
||
documents: nil,
|
||
exp_month: nil,
|
||
exp_year: nil,
|
||
expand: nil,
|
||
metadata: nil,
|
||
name: nil
|
||
); end
|
||
end
|
||
class ListParams < Stripe::RequestParams
|
||
# A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
|
||
sig { returns(T.nilable(String)) }
|
||
def ending_before; end
|
||
sig { params(_ending_before: T.nilable(String)).returns(T.nilable(String)) }
|
||
def ending_before=(_ending_before); end
|
||
# Specifies which fields in the response should be expanded.
|
||
sig { returns(T.nilable(T::Array[String])) }
|
||
def expand; end
|
||
sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
|
||
def expand=(_expand); end
|
||
# 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)) }
|
||
def limit; end
|
||
sig { params(_limit: T.nilable(Integer)).returns(T.nilable(Integer)) }
|
||
def limit=(_limit); end
|
||
# Filter external accounts according to a particular object type.
|
||
sig { returns(T.nilable(String)) }
|
||
def object; end
|
||
sig { params(_object: T.nilable(String)).returns(T.nilable(String)) }
|
||
def object=(_object); end
|
||
# 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)) }
|
||
def starting_after; end
|
||
sig { params(_starting_after: T.nilable(String)).returns(T.nilable(String)) }
|
||
def starting_after=(_starting_after); end
|
||
sig {
|
||
params(ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), limit: T.nilable(Integer), object: T.nilable(String), starting_after: T.nilable(String)).void
|
||
}
|
||
def initialize(
|
||
ending_before: nil,
|
||
expand: nil,
|
||
limit: nil,
|
||
object: nil,
|
||
starting_after: nil
|
||
); end
|
||
end
|
||
class CreateParams < Stripe::RequestParams
|
||
class BankAccount < Stripe::RequestParams
|
||
# Attribute for param field object
|
||
sig { returns(String) }
|
||
def object; end
|
||
sig { params(_object: String).returns(String) }
|
||
def object=(_object); end
|
||
# The name of the person or business that owns the bank account.This field is required when attaching the bank account to a `Customer` object.
|
||
sig { returns(T.nilable(String)) }
|
||
def account_holder_name; end
|
||
sig { params(_account_holder_name: T.nilable(String)).returns(T.nilable(String)) }
|
||
def account_holder_name=(_account_holder_name); end
|
||
# The type of entity that holds the account. It can be `company` or `individual`. This field is required when attaching the bank account to a `Customer` object.
|
||
sig { returns(T.nilable(String)) }
|
||
def account_holder_type; end
|
||
sig { params(_account_holder_type: T.nilable(String)).returns(T.nilable(String)) }
|
||
def account_holder_type=(_account_holder_type); end
|
||
# The account number for the bank account, in string form. Must be a checking account.
|
||
sig { returns(String) }
|
||
def account_number; end
|
||
sig { params(_account_number: String).returns(String) }
|
||
def account_number=(_account_number); end
|
||
# The country in which the bank account is located.
|
||
sig { returns(String) }
|
||
def country; end
|
||
sig { params(_country: String).returns(String) }
|
||
def country=(_country); end
|
||
# The currency the bank account is in. This must be a country/currency pairing that [Stripe supports.](docs/payouts)
|
||
sig { returns(T.nilable(String)) }
|
||
def currency; end
|
||
sig { params(_currency: T.nilable(String)).returns(T.nilable(String)) }
|
||
def currency=(_currency); end
|
||
# The routing number, sort code, or other country-appropriate institution number for the bank account. For US bank accounts, this is required and should be the ACH routing number, not the wire routing number. If you are providing an IBAN for `account_number`, this field is not required.
|
||
sig { returns(T.nilable(String)) }
|
||
def routing_number; end
|
||
sig { params(_routing_number: T.nilable(String)).returns(T.nilable(String)) }
|
||
def routing_number=(_routing_number); end
|
||
sig {
|
||
params(object: String, account_holder_name: T.nilable(String), account_holder_type: T.nilable(String), account_number: String, country: String, currency: T.nilable(String), routing_number: T.nilable(String)).void
|
||
}
|
||
def initialize(
|
||
object: nil,
|
||
account_holder_name: nil,
|
||
account_holder_type: nil,
|
||
account_number: nil,
|
||
country: nil,
|
||
currency: nil,
|
||
routing_number: nil
|
||
); end
|
||
end
|
||
class Card < Stripe::RequestParams
|
||
# Attribute for param field object
|
||
sig { returns(String) }
|
||
def object; end
|
||
sig { params(_object: String).returns(String) }
|
||
def object=(_object); end
|
||
# Attribute for param field address_city
|
||
sig { returns(T.nilable(String)) }
|
||
def address_city; end
|
||
sig { params(_address_city: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_city=(_address_city); end
|
||
# Attribute for param field address_country
|
||
sig { returns(T.nilable(String)) }
|
||
def address_country; end
|
||
sig { params(_address_country: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_country=(_address_country); end
|
||
# Attribute for param field address_line1
|
||
sig { returns(T.nilable(String)) }
|
||
def address_line1; end
|
||
sig { params(_address_line1: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_line1=(_address_line1); end
|
||
# Attribute for param field address_line2
|
||
sig { returns(T.nilable(String)) }
|
||
def address_line2; end
|
||
sig { params(_address_line2: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_line2=(_address_line2); end
|
||
# Attribute for param field address_state
|
||
sig { returns(T.nilable(String)) }
|
||
def address_state; end
|
||
sig { params(_address_state: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_state=(_address_state); end
|
||
# Attribute for param field address_zip
|
||
sig { returns(T.nilable(String)) }
|
||
def address_zip; end
|
||
sig { params(_address_zip: T.nilable(String)).returns(T.nilable(String)) }
|
||
def address_zip=(_address_zip); end
|
||
# Attribute for param field currency
|
||
sig { returns(T.nilable(String)) }
|
||
def currency; end
|
||
sig { params(_currency: T.nilable(String)).returns(T.nilable(String)) }
|
||
def currency=(_currency); end
|
||
# Attribute for param field cvc
|
||
sig { returns(T.nilable(String)) }
|
||
def cvc; end
|
||
sig { params(_cvc: T.nilable(String)).returns(T.nilable(String)) }
|
||
def cvc=(_cvc); end
|
||
# Attribute for param field exp_month
|
||
sig { returns(Integer) }
|
||
def exp_month; end
|
||
sig { params(_exp_month: Integer).returns(Integer) }
|
||
def exp_month=(_exp_month); end
|
||
# Attribute for param field exp_year
|
||
sig { returns(Integer) }
|
||
def exp_year; end
|
||
sig { params(_exp_year: Integer).returns(Integer) }
|
||
def exp_year=(_exp_year); end
|
||
# Attribute for param field name
|
||
sig { returns(T.nilable(String)) }
|
||
def name; end
|
||
sig { params(_name: T.nilable(String)).returns(T.nilable(String)) }
|
||
def name=(_name); end
|
||
# Attribute for param field number
|
||
sig { returns(String) }
|
||
def number; end
|
||
sig { params(_number: String).returns(String) }
|
||
def number=(_number); end
|
||
# 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])) }
|
||
def metadata; end
|
||
sig {
|
||
params(_metadata: T.nilable(T::Hash[String, String])).returns(T.nilable(T::Hash[String, String]))
|
||
}
|
||
def metadata=(_metadata); end
|
||
sig {
|
||
params(object: String, address_city: T.nilable(String), address_country: T.nilable(String), address_line1: T.nilable(String), address_line2: T.nilable(String), address_state: T.nilable(String), address_zip: T.nilable(String), currency: T.nilable(String), cvc: T.nilable(String), exp_month: Integer, exp_year: Integer, name: T.nilable(String), number: String, metadata: T.nilable(T::Hash[String, String])).void
|
||
}
|
||
def initialize(
|
||
object: nil,
|
||
address_city: nil,
|
||
address_country: nil,
|
||
address_line1: nil,
|
||
address_line2: nil,
|
||
address_state: nil,
|
||
address_zip: nil,
|
||
currency: nil,
|
||
cvc: nil,
|
||
exp_month: nil,
|
||
exp_year: nil,
|
||
name: nil,
|
||
number: nil,
|
||
metadata: nil
|
||
); end
|
||
end
|
||
class CardToken < Stripe::RequestParams
|
||
# Attribute for param field object
|
||
sig { returns(String) }
|
||
def object; end
|
||
sig { params(_object: String).returns(String) }
|
||
def object=(_object); end
|
||
# Attribute for param field currency
|
||
sig { returns(T.nilable(String)) }
|
||
def currency; end
|
||
sig { params(_currency: T.nilable(String)).returns(T.nilable(String)) }
|
||
def currency=(_currency); end
|
||
# Attribute for param field token
|
||
sig { returns(String) }
|
||
def token; end
|
||
sig { params(_token: String).returns(String) }
|
||
def token=(_token); end
|
||
sig { params(object: String, currency: T.nilable(String), token: String).void }
|
||
def initialize(object: nil, currency: nil, token: nil); end
|
||
end
|
||
# When set to true, or if this is the first external account added in this currency, this account becomes the default external account for its currency.
|
||
sig { returns(T.nilable(T::Boolean)) }
|
||
def default_for_currency; end
|
||
sig { params(_default_for_currency: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
|
||
def default_for_currency=(_default_for_currency); end
|
||
# Specifies which fields in the response should be expanded.
|
||
sig { returns(T.nilable(T::Array[String])) }
|
||
def expand; end
|
||
sig { params(_expand: T.nilable(T::Array[String])).returns(T.nilable(T::Array[String])) }
|
||
def expand=(_expand); end
|
||
# A token, like the ones returned by [Stripe.js](https://stripe.com/docs/js) or a dictionary containing a user's external account details (with the options shown below). Please refer to full [documentation](https://stripe.com/docs/api/external_accounts) instead.
|
||
sig {
|
||
returns(T.any(String, ::Stripe::AccountExternalAccountService::CreateParams::Card, ::Stripe::AccountExternalAccountService::CreateParams::BankAccount, ::Stripe::AccountExternalAccountService::CreateParams::CardToken))
|
||
}
|
||
def external_account; end
|
||
sig {
|
||
params(_external_account: T.any(String, ::Stripe::AccountExternalAccountService::CreateParams::Card, ::Stripe::AccountExternalAccountService::CreateParams::BankAccount, ::Stripe::AccountExternalAccountService::CreateParams::CardToken)).returns(T.any(String, ::Stripe::AccountExternalAccountService::CreateParams::Card, ::Stripe::AccountExternalAccountService::CreateParams::BankAccount, ::Stripe::AccountExternalAccountService::CreateParams::CardToken))
|
||
}
|
||
def external_account=(_external_account); end
|
||
# 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])) }
|
||
def metadata; end
|
||
sig {
|
||
params(_metadata: T.nilable(T::Hash[String, String])).returns(T.nilable(T::Hash[String, String]))
|
||
}
|
||
def metadata=(_metadata); end
|
||
sig {
|
||
params(default_for_currency: T.nilable(T::Boolean), expand: T.nilable(T::Array[String]), external_account: T.any(String, ::Stripe::AccountExternalAccountService::CreateParams::Card, ::Stripe::AccountExternalAccountService::CreateParams::BankAccount, ::Stripe::AccountExternalAccountService::CreateParams::CardToken), metadata: T.nilable(T::Hash[String, String])).void
|
||
}
|
||
def initialize(
|
||
default_for_currency: nil,
|
||
expand: nil,
|
||
external_account: nil,
|
||
metadata: nil
|
||
); end
|
||
end
|
||
# Create an external account for a given account.
|
||
sig {
|
||
params(account: String, params: T.any(::Stripe::AccountExternalAccountService::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(T.any(Stripe::BankAccount, Stripe::Card))
|
||
}
|
||
def create(account, params = {}, opts = {}); end
|
||
|
||
# Delete a specified external account for a given account.
|
||
sig {
|
||
params(account: String, id: String, params: T.any(::Stripe::AccountExternalAccountService::DeleteParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(T.any(Stripe::BankAccount, Stripe::Card))
|
||
}
|
||
def delete(account, id, params = {}, opts = {}); end
|
||
|
||
# List external accounts for an account.
|
||
sig {
|
||
params(account: String, params: T.any(::Stripe::AccountExternalAccountService::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
|
||
}
|
||
def list(account, params = {}, opts = {}); end
|
||
|
||
# Retrieve a specified external account for a given account.
|
||
sig {
|
||
params(account: String, id: String, params: T.any(::Stripe::AccountExternalAccountService::RetrieveParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(T.any(Stripe::BankAccount, Stripe::Card))
|
||
}
|
||
def retrieve(account, id, params = {}, opts = {}); end
|
||
|
||
# Updates the metadata, account holder name, account holder type of a bank account belonging to
|
||
# a connected account and optionally sets it as the default for its currency. Other bank account
|
||
# details are not editable by design.
|
||
#
|
||
# You can only update bank accounts when [account.controller.requirement_collection is application, which includes <a href="/connect/custom-accounts">Custom accounts](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection).
|
||
#
|
||
# You can re-enable a disabled bank account by performing an update call without providing any
|
||
# arguments or changes.
|
||
sig {
|
||
params(account: String, id: String, params: T.any(::Stripe::AccountExternalAccountService::UpdateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(T.any(Stripe::BankAccount, Stripe::Card))
|
||
}
|
||
def update(account, id, params = {}, opts = {}); end
|
||
end
|
||
end |