---
title: "Delete a Merchant Settlement Account"
method: DELETE
path: "/v1/accounts/{accountId}"
tags: ["Settlement Accounts"]
---

# Delete a Merchant Settlement Account

`DELETE /v1/accounts/{accountId}`

The **Delete a Merchant Settlement Account** endpoint allows you to remove an existing merchant settlement account from your organization using the account's unique ID. This action is irreversible. Use this endpoint when you need to decommission an account that is no longer in use.

## Path parameters

- `accountId` integer, required

## Response `200`

Successfully deletes the 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

- `404` — The specified merchant settlement account does not exist.

---

[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)