---
title: "ClearingAccounts:Create"
method: POST
path: "/clearingaccounts"
tags: ["ClearingAccounts"]
---

# ClearingAccounts:Create

`POST /clearingaccounts`

Creates a new clearing account for a merchant. The clearing accounts needs to be a business clearing account, private accounts are not accepted. You can also supply a merchantCode. If a merchantCode is supplied then you need to have access to that merchant

## Request body

- object
  - `merchantCode` string
  - `clearingAccount` object
    - `method` Method, required — unresolved $ref
    - `iban` BankAccount, required
      - `iban` string, required — The International Bank Account Number (IBAN).
      - `bic` string, required — Business Identifier Codes (BIC/SWIFT).
      - `owner` string, required — The owner of the bank account.
    - `documents` object
      - `fileName` string, required — The filename for the document file, which can be a PDF, PNG, GIF or JP(E)G
      - `files` string[], required — An array of (base64 encoded) content (strings) of the files for the document

## Response `201`

Created

- MerchantBankAccount
  - `code` string — The merchant bank account id of your company starting with BA.
  - `status` string — The current check status of the clearing account.
  - `method` string — The method to add the clearing account. NOTE: Only 'iban' is supported for now!
  - `iban` BankAccount
    - `iban` string, required — The International Bank Account Number (IBAN).
    - `bic` string, required — Business Identifier Codes (BIC/SWIFT).
    - `owner` string, required — The owner of the bank account.
  - `merchant` MerchantMinimal
    - `code` string, required — The merchant id of your company starting with M.
    - `name` string, required — The name of your merchant.
    - `status` string, required — Merchant state
    - `incorporationCountry` string — The incorporationCountry field represents the country in which the entity is legally registered or incorporated.
  - `createdAt` CreatedAt — unresolved $ref
  - `createdBy` CreatedBy — unresolved $ref
  - `modifiedAt` ModifiedAt — unresolved $ref
  - `modifiedBy` ModifiedBy — unresolved $ref
  - `deletedAt` DeletedAt — unresolved $ref
  - `deletedBy` DeletedBy — unresolved $ref

## Other responses

- `400` — Bad request, see response body for more information
- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `415` — Unsupported media. The supplied content type in the content-type parameter in the header is not supported
- `422` — Unprocessable entity, see response body for more information
- `429` — Rate limit reached.
- `500` — An internal error occurred.

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)