Create a new Bank account

post

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

Use this endpoint to create a new Bank account in TIS. Provide all required and valid Bank details in the request body to ensure successful creation.

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

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201The id of the created Bank account

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