Update a bank account

Changed on

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 Custom accounts.

You can re-enable a disabled bank account by performing an update call without providing any arguments or changes.

post/v1/external_accounts/{id}

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/external_accounts/{id}
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

idstring required

Request body application/x-www-form-urlencoded

account_holder_namestring

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

account_holder_type'' | 'company' | 'individual'

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

account_type'checking' | 'futsu' | 'savings' | 'toza'

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

address_citystring

City/District/Suburb/Town/Village.

address_countrystring

Billing address country, if provided when creating card.

address_line1string

Address line 1 (Street address/PO Box/Company name).

address_line2string

Address line 2 (Apartment/Suite/Unit/Building).

address_statestring

State/County/Province/Region.

address_zipstring

ZIP or postal code.

default_for_currencyboolean

When set to true, this becomes the default external account for its currency.

exp_monthstring

Two digit number representing the card’s expiration month.

exp_yearstring

Four digit number representing the card’s expiration year.

expandstring[]

Specifies which fields in the response should be expanded.

namestring

Cardholder name.

Response

Successful response.

OR

Changes

  • 585b581504aeRevision changes
    • warning

      added the new final_payment_failure enum value to the ///////// response property for the response status

    • warning

      added the new first_payment_failure enum value to the ///////// response property for the response status

  • 7537419124b6Revision changes
    • info

      added the optional property ////// to the response with the status

Some revisions have not been checked yet.