When you create a new bank account, you must specify a Customer
object on which to create it.
Parameters
- sourceobject | stringRequired
Either a token, like the ones returned by Stripe.js, or a dictionary containing a user’s bank account details (with the options shown below).
- source.
account_ numberstringRequired The account number for the bank account, in string form. Must be a checking account.
- source.
countrystringRequired The country in which the bank account is located.
- source.
currencystringRequired The currency the bank account is in. This must be a country/currency pairing that Stripe supports.
- source.
objectstringRequired The type of external account. Should be
bank_
account - source.
account_ holder_ namestring 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. - source.
account_ holder_ typeenum The type of entity that holds the account. This field is required when attaching the bank account to a
Customer
object.Possible enum valuescompany
individual
- source.
routing_ numberstring 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_
, this field is not required.number
- metadataobject
Set of key-value pairs 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
.
Returns
Returns the bank account object.
{ "id": "ba_1MvoIJ2eZvKYlo2CO9f0MabO", "object": "bank_account", "account_holder_name": "Jane Austen", "account_holder_type": "company", "account_type": null, "bank_name": "STRIPE TEST BANK", "country": "US", "currency": "usd", "customer": "cus_9s6XI9OFIdpjIg", "fingerprint": "1JWtPxqbdX5Gamtc", "last4": "6789", "metadata": {}, "routing_number": "110000000", "status": "new"}