Create a new Bank

post

https://api-mtls.eu.tispayments.com/rest/api/v2/bam/banks

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

Body Params

businessId

string

length ≤ 45

A unique identifier that can be provided to link the bank entity in TIS to an entity in a third party system. If not specified, it will be automatically generated in TIS in the following format "BAXXXXXX". Optional field, supports alphanumeric value up to 45 characters.

name

string

required

length ≤ 140

Name of the bank. Required field. Supports alphanumeric value up to 140 characters.

bic

string

length between 8 and 11

BIC code of the bank. Optional field. Supports alphanumeric value, either 8 or 11 characters.

code

string

length ≤ 64

Bank code of the bank. Optional field. Supports alphanumeric value of up to 64 characters.

branchCode

string

length ≤ 35

Branch code of the bank. Optional field. Supports alphanumeric value up to 35 character

country

string

required

length ≤ 2

A country of the bank. Required field. Supports two-letters ISO 3166-1 alpha-2 code.

city

string

length ≤ 64

A city of the bank. Optional field. Supports alphanumeric value of up to 64 characters.

zipCode

string

length ≤ 64

A postal code of bank's address. Optional field. Supports alphanumeric value of up to 64 characters.

address

string

length ≤ 255

An address of the bank. ** Optional field. Supports alphanumeric value of up to 255 characters.

language

string

length ≤ 4

Language of the correspondence. Optional field. Supports predefined set of values, each represented as a 4 character code ISO 639-1 language code and ISO 3166-1 country code.

inHouse

boolean

A flag specifying if an In-House banking is supported. Supports Boolean value.

bankGroupId

string

A unique identifier for a bank group used in TIS. Use this field if you want to associate a bank with a bank group. Optional field. A bank group ID can be retrieved by GET bank groups endpoint.

customFields

array of objects

customFields

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

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

application/problem+json

201The id of the created Bank

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