---
title: "Update Settlement Account"
method: PATCH
path: "/v3/settlement-account/{settlementAccountId}"
tags: ["Settlement Accounts"]
---

# Update Settlement Account

`PATCH /v3/settlement-account/{settlementAccountId}`

Update an existing settlement account. All request body fields are optional — send only the fields you want to update. The current default settlement account cannot be marked as inactive. To mark it as inactive, first set another settlement account as the default.

## Path parameters

- `settlementAccountId` string, required

## Headers

- `MID` string, required

## Request body

- object
  - `status` 'active' | 'inactive' — Settlement account status
  - `accountAlias` string — Human-readable alias for the settlement account
  - `isVerified` boolean — Marks the account as verified. When set to true, the verification timestamp is recorded.
  - `verifiedBy` string — Identifier of who verified the account
  - `setAsDefault` boolean — When true, makes this the default settlement account for its type and unsets the default flag on all other accounts of the same type.

## Response `200`

Settlement account updated successfully

- object
  - `status` string
  - `message` string
  - `data` object
    - `settlementAccountId` string
    - `status` string
    - `accountAlias` string
    - `isVerified` boolean
    - `verifiedAt` string, date-time
    - `verifiedBy` string
    - `default` boolean

## Other responses

- `400` — Validation error
- `500` — Internal server error

---

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