Create a bank account 

Payment Methods
Bank Accounts
Create a bank account

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 values
      company
      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_number, this field is not required.

  • 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.

POST /v1/customers/:id/sources
curl https://api.stripe.com/v1/customers/cus_9s6XI9OFIdpjIg/sources \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d source=btok_1MvoS32eZvKYlo2CDhGTErAe
Response
{
"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"
}