Update a Bank account

put

https://api-mtls.eu.tispayments.com/rest/api/bam/bank-accounts/{bankAccountId}

Use this endpoint to update the details of an existing Bank account using its identifier. Provide all valid and available bank group fields in the request body, otherwise, omitted fields will be lost or overwritten with TIS default values.

Path Params

bankAccountId

string

required

Unique UUID identifier of the Bank account

Body Params

businessId

string

length ≤ 45

Identifier provided by the client for linking the banking account to an entity in a third-party system. If not provided, it will be automatically generated at TIS by using following format "BAXXXXXX""

iban

string

length ≤ 34

Defaults to null

The international bank account number made up of up to 34 letters and numbers. Either iban or bank account number is required.

accountNumber

string

length ≤ 64

Defaults to null

The bank account's local account number. Either iban or bank account number is required.

currency

string

enum

required

length ≤ 3

The 3-character ISO-4217 currency code indicating the operating currency of the bank account. For example, the currency code of United Kingdom is GBP

accountType

string

enum

The financial purpose of the associated bank account

subAccountNumber

string

length ≤ 64

Defaults to null

The bank account's sub account number

generalLedgerNumber

string

length ≤ 45

Defaults to null

General ledger number for the bank account

mt940Identifier

string

length ≤ 255

Defaults to null

Account identification as per the corresponding MT940 reporting (tag 25)

longDescription

string

length ≤ 512

Defaults to null

Bank account description up to 512 characters

shortDescription

string

length ≤ 64

Defaults to null

Bank account description up to 64 characters

virtualAccount

boolean

Defaults to false

Condition describing if a bank account is virtual

bankId

uuid

required

Id of the bank that holds the account

legalEntityId

uuid

required

Id of the Legal entity to which the account belongs

chargesAccountId

uuid

Defaults to null

Id of the charges account attached to this account

customFields

array of objects

customFields

Responses

5XX

Error response code which is returned when an internal server error occurs

200Updated Bank account

4XXError caused by the client, like invalid inputs or missing authorization.