---
title: "Registers a new bank account related to a merchant."
method: POST
path: "/bank-accounts"
---

# Registers a new bank account related to a merchant.

`POST /bank-accounts`

## Request

- Base URL: `https://api.test.kalixa.com/payment-service/v6`
- URL: `https://api.test.kalixa.com/payment-service/v6/bank-accounts`
- Auth: HTTP basic

Registers a new bank account related to a merchant.

## Request body

- NewBankAccount: Contains the data of the new bank account.
  - `bankName` string, required: The name of the bank at which this account is held. Used for settlement purposes.
  - `accountNumber` string: The account number of the bank account. Should only be provided if the account does not have an IBAN. Used for settlement purposes if no IBAN provided.
  - `bankCode` string: The bank code of the bank at which this account is held. Should only be provided if the account does not have a BIC code. Used for settlement purposes if no BIC provided.
  - `countryCode` string, required: The country code for the country in which this account was created as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `currencyCode` string, required: The currency code for the currency in which the account is held as ISO 4217 3-digit code (https://en.wikipedia.org/wiki/ISO_4217).
  - `holderName` string, required: The name of the person that is registered as the account holder.
  - `iban` string: The IBAN of the account. Used for settlement purposes.
  - `bic` string: The BIC code of the bank at which this account is held.
  - `merchantId` string, required: The id of the merchant to which this bank account should be associated with. Used for associating the company with the merchant.

## Response `201`

Successful operation

- BankAccount: Contains the bank account data.
  - `id` string: The server-generated id of the bank account which was registered or returned. Used for identifying the bank account in other methods e.g. getBankAccount.
  - `bankName` string: The name of the bank at which this account is held. Used for settlement purposes.
  - `accountNumber` string: The account number of the bank account. Should only be provided if the account does not have an IBAN. Used for settlement purposes if no IBAN provided.
  - `bankCode` string: The bank code of the bank at which this account is held. Should only be provided if the account does not have a BIC code. Used for settlement purposes if no BIC provided.
  - `countryCode` string: The country code for the country in which this account was created as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `currencyCode` string: The currency code for the currency in which the account is held as ISO 4217 3-digit code (https://en.wikipedia.org/wiki/ISO_4217).
  - `holderName` string: The name of the person that is registered as the account holder.
  - `iban` string: The IBAN of the account. Used for settlement purposes.
  - `bic` string: The BIC code of the bank at which this account is held.
  - `merchant` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `documents` ObjectWithId[]
    - `id` string: The id of the resource.

## Other responses

- `400`: Error occurred

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/revisions/066120f66046?raw)