Update a bank account 

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.

Parameters

• default_for_currencyboolean

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

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

More parameters

Collapse all

• account_holder_namestring

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

• account_holder_typestring

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

• account_typestring

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

• documentsobject

  Documents that may be submitted to satisfy various informational requests.

  Hide child parameters

  • documents.bank_account_ownership_verificationobject

    One or more documents that support the 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.

    Hide child parameters

    • documents.bank_account_ownership_verification.filesarray of strings

      One or more document ids returned by a file upload with a purpose value of account_requirement.