Skip to main content
PATCH
Update external account

Authorizations

Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Headers

X-Organization-ID
string<uuid>

ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.

Path Parameters

id
string<uuid>
required

The external bank account ID.

Body

The update request.

Request to update an external bank account. Uses Tesouro.Common.Types.Rest.Optional&lt;T&gt; with non-nullable inner types — FIS does not support clearing any of these fields, so absent fields preserve the stored value.

accountHolderType
enum<string>

Holder of the bank account (individual or business). Absent = preserve.

Available options:
INDIVIDUAL,
BUSINESS
nameOnAccount
string

New name on the external bank account. Absent = preserve.

nickname
string

New nickname for the external bank account. Absent = preserve.

verification
object

Verification status update. Requires 'CanSetExternalBankAccountVerification' permission. Absent = preserve.

Response

External bank account updated.

Response representing an external bank account.

id
string<uuid>
required

Unique identifier for the external bank account.

accountNumber
string
required

Masked account number (last 4 digits visible).

accountStatus
enum<string>
required

Status of the external bank account.

Available options:
ACTIVE,
INACTIVE
nameOnAccount
string
required

Name on the bank account.

nickname
string
required

Nickname for the external bank account.

routingNumber
string
required

Bank routing number (ABA number).

type
enum<string>
required

Type of bank account (checking or savings).

Available options:
CHECKING,
SAVINGS
verificationStatus
enum<string>
required

Verification status of the external bank account. Where the bank fails verification on the first incorrect attempt, FAILED can be recovered while attempts remain. Where it fails at the attempt limit, or after a returned micro-deposit or a notification of change, FAILED is final.

Available options:
UNVERIFIED,
VERIFICATION_SENT,
VERIFIED,
FAILED
accountHolderType
null | enum<string>

Holder of the bank account (individual or business).

Available options:
INDIVIDUAL,
BUSINESS
microDepositVerification
null | object

Result of the micro-deposit validation attempt. Returned by the validate endpoint only.

suspension
null | object

Why no payment may be sent to or taken from the account, or null when it is usable.

verificationFailure
null | object

Why verification failed, when verificationStatus is FAILED.