Skip to main content
Schema2020-08-27object

bank_account

These bank accounts are payment methods on `Customer` objects. On the other hand [External Accounts](https://stripe.com/docs/api#external_accounts) are transfer destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts). They can be bank accounts or debit cards as well, and are documented in the links above. Related guide: [Bank Debits and Transfers](https://stripe.com/docs/payments/bank-debits-transfers).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

BankAccount

object

These bank accounts are payment methods on `Customer` objects. On the other hand [External Accounts](https://stripe.com/docs/api#external_accounts) are transfer destinations on `Account` objects for [Custom accounts](https://stripe.com/docs/connect/custom-accounts). They can be bank accounts or debit cards as well, and are documented in the links above. Related guide: [Bank Debits and Transfers](https://stripe.com/docs/payments/bank-debits-transfers).

account
optionalnullable

The ID of the account that the bank account is associated with.

account_holder_name string
optionalnullable

The name of the person or business that owns the bank account.

account_holder_type string
optionalnullable

The type of entity that holds the account. This can be either `individual` or `company`.

account_type string
optionalnullable

The bank account type. This can only be `checking` or `savings` in most countries. In Japan, this can only be `futsu` or `toza`.

available_payout_methods array
optionalnullable

A set of available payout methods for this bank account. Only values from this set should be passed as the `method` when creating a payout.

bank_name string
optionalnullable

Name of the bank associated with the routing number (e.g., `WELLS FARGO`).

country string
required

Two-letter ISO code representing the country the bank account is located in.

currency string
required

Three-letter [ISO code for the currency](https://stripe.com/docs/payouts) paid out to the bank account.

customer
optionalnullable

The ID of the customer that the bank account is associated with.

default_for_currency boolean
optionalnullable

Whether this bank account is the default external account for its currency.

fingerprint string
optionalnullable

Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.

id string
required

Unique identifier for the object.

last4 string
required

The last four digits of the bank account number.

metadata object
optionalnullable

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.

object string
required

String representing the object's type. Objects of the same type share the same value.

routing_number string
optionalnullable

The routing transit number for the bank account.

status string
required

For bank accounts, possible values are `new`, `validated`, `verified`, `verification_failed`, or `errored`. A bank account that hasn't had any activity or validation performed is `new`. If Stripe can determine that the bank account exists, its status will be `validated`. Note that there often isn’t enough information to know (e.g., for smaller credit unions), and the validation is not always run. If customer bank account verification has succeeded, the bank account status will be `verified`. If the verifica…