---
title: "Merchant:UpdateSettings"
method: PATCH
path: "/v2/merchants/{merchantCode}/settings"
tags: ["Merchants"]
---

# Merchant:UpdateSettings

`PATCH /v2/merchants/{merchantCode}/settings`

Update the settings for a merchant. If a merchantCode is supplied then you need to have access to that merchant.

## Path parameters

- `merchantCode` string, required

## Request body

- MerchantSettingsInput — Input for updating Merchant Settings.
  - `clearing` MerchantSettingsInputClearingSettings — Input for updating the Clearing Settings in the Merchant Settings.
    - `clearingPeriod` 'DAY' | 'WEEK' | 'MONTH' | 'null', nullable
    - `clearingFrequency` 'MANUAL' | 'DAY' | 'WEEK' | 'MONTH' | 'null', nullable
    - `invoicePeriod` 'WEEK' | 'MONTH' | 'null', nullable
    - `invoiceFrequency` 'WEEK' | 'MONTH' | 'DAY' | 'null', nullable
    - `splitByTurnoverGroup` boolean, nullable
    - `settlementPerClearing` boolean, nullable
    - `clearingMoment` 'DIRECT' | 'COLLECT' | 'null', nullable
    - `mt940` MerchantSettingsInputMt940 — Input for updating the Clearing MT940 settings within the Merchant Settings.
      - `bankAccount` string, nullable
      - `type` 'STANDARD' | 'TWINFIELD' | 'CUSTOM' | 'null', nullable
      - `customInput` string, nullable
  - `layout` MerchantSettingsInputLayoutSettings — Input for updating Layout Settings within merchant Settings.
    - `code` string, nullable

## Response `200`

OK

- MerchantMerchantOutputSettingsOutput — Represents the Settings information in the merchant output.
  - `clearing` MerchantMerchantOutputSettingsOutputClearingSettings — Represents the Clearing configuration information in the merchant output.
    - `clearingPeriod` string
    - `clearingFrequency` string
    - `invoicePeriod` string
    - `invoiceFrequency` string
    - `splitByTurnoverGroup` boolean
    - `settlementPerClearing` boolean, nullable
    - `clearingMoment` string
    - `mt940` MerchantMerchantOutputSettingsOutputClearingSettingsMt940Settings — Represents the Merchant MT940 settings in the Clearing Settings output.
      - `bankAccount` string, nullable
      - `type` string
      - `customInput` string, nullable
  - `layout` MerchantMerchantOutputSettingsOutputLayoutSettings — Represents the Layout settings in the Settings output.
    - `code` string, nullable

## Other responses

- `400` — Bad request, see response body for more information
- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `404` — Resource not found
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `410` — Indicates that this resource is no longer available for use
- `415` — Unsupported media. The supplied content type in the content-type parameter in the header is not supported
- `422` — Unprocessable entity
- `429` — Rate limit reached.
- `500` — An internal error occurred.
- `503` — The server is currently unable to handle your request

---

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