---
title: "Create a Merchant Settlement Account"
method: POST
path: "/v1/accounts"
tags: ["Settlement Accounts"]
---

# Create a Merchant Settlement Account

`POST /v1/accounts`

The **Create a Merchant Settlement Account** endpoint allows you to add a new settlement account to your organization. Provide necessary details such as account type, supported currencies, and blockchain network information. Uniqueness checks will be performed to ensure that the combination of `org_id`, `reference`, `chain_id`, and `currency` is unique. Use this endpoint to expand your settlement options and manage payouts effectively.

## Request body

- CreateAccountRequest
  - `name` string, string, required — The name assigned to the merchant settlement account. This name will help you identify the account within your organization.
  - `reference` string, string, required — A reference code used to group and manage multiple merchant settlement accounts. This helps in bundling accounts for organizational purposes.
  - `type` 'CryptoPayIn', required — The type of merchant settlement account, indicating the settlement method. Currently, only **CryptoPayIn** is supported. This defines how transactions will be processed for the account.
  - `chain_id` number, required — The blockchain network identifier for the merchant settlement account. This specifies the network on which the account operates. Find the identifier for each network in the [Network & Currencies guide](/docs/networks-and-currencies).
  - `address` string, string, required — The wallet address associated with the merchant settlement account. Ensure that this address is accurate to facilitate proper transaction settlements.
  - `currencies` string[], required — A list of currency codes supported by this account. Please provide the currency codes that the settlement account can accept.

## Response `200`

Successfully creates merchant settlement account.

- Account
  - `data` AccountDetails
    - `id` integer — A unique identifier for the merchant settlement account.
    - `org_id` string — The unique identifier of your organization.
    - `parent_id` integer, nullable — The identifier of the parent merchant settlement account, if applicable.
    - `reference` string — A reference code to group and manage multiple merchant settlement accounts.
    - `account_type` 'CryptoPayIn' | 'CryptoPayOut' | 'FiatPayIn' | 'FiatPayOut' | 'Crypto' | 'Bank' | 'Card' | 'MPCVault' | 'GooglePay' | 'ApplePay' — The type of merchant settlement account, indicating the settlement method.
    - `name` string — The name assigned to the merchant settlement account.
    - `chain_id` integer — The blockchain network identifier (e.g., 1 for Ethereum Mainnet, 8453 for Base Mainnet).
    - `address` string — The wallet address associated with the merchant settlement account.
    - `currencies` string[] — A list of currency codes that the account supports. Possible values are: - **ETH**: Ethereum - **USDC**: USD Coin - **USDT**: Tether - **WETH**: Wrapped Ether - **DAI**: Dai Stablecoin - **SOL**: Solana Ensure that the currencies listed are supported by the account's blockchain network and are relevant to your transaction needs.
    - `account_number` string — The account number for fiat settlement accounts. Empty if not applicable.
    - `sort_code` string — The bank sort code for fiat settlement accounts. Empty if not applicable.
    - `enabled` boolean — Indicates whether this merchant settlement account is currently enabled.
    - `state` 'Unknown' | 'Pending' | 'Ready' — The current state of the merchant settlement account.
    - `created_by` string — The identifier of the user who created this account.
    - `created_at` string, date-time — The timestamp when the merchant settlement account was created.
    - `updated_at` string, date-time — The timestamp when the merchant settlement account was last updated.
    - `deleted_at` string, date-time, nullable — The timestamp when the merchant settlement account was deleted, if applicable.
  - `message` string — A message indicating the result of the operation.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/boomfi/apis/boomfi-merchants-api.md) · [All operations](https://skmtc.net/boomfi/apis/boomfi-merchants-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/boomfi/boomfi-merchants-api/revisions/ace3c3df05fe/schema)