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

# Update a Merchant Settlement Account

`PATCH /v1/accounts/{accountId}`

The **Update a Merchant Settlement Account** endpoint allows you to modify the details of an existing merchant settlement account identified by its unique ID. You can update fields such as the account name, wallet address, supported currencies, and enable or disable the account. Use this endpoint to keep your account information current and to manage account settings.

## Path parameters

- `accountId` integer, required

## Request body

- UpdateAccountRequest
  - `name` string, string, nullable — The new name for the merchant settlement account. If provided, this value will update the account's existing name.
  - `address` string, string, nullable — The new wallet address for the merchant settlement account. If provided, this value will update the account's existing address.
  - `currencies` string[] — A list of currency codes to update the supported currencies of the account. This list will replace the account's current supported currencies.
  - `enabled` boolean — A flag to enable or disable the merchant settlement account. Set to `true` to enable the account or `false` to disable it.

## Response `200`

Successfully updates 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

- `400` — Bad Request

---

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