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

# Merchant:Update

`PATCH /merchants/{merchantCode}`

Update the merchant data. If you want to update the relating objects (e.g. authentication tokens or accounts etc) you can use the specific endpoints for that. You need to have access to the merchantCode that you supply or it needs to be your own merchantCode. You need to authenticate with an AT-code as username and the corresponding token as password.

## Path parameters

- `merchantCode` Code, required — unresolved $ref

## Request body

- object
  - `merchant` object, required
    - `name` Name — unresolved $ref
    - `publicName` PublicName — unresolved $ref
    - `coc` Coc — unresolved $ref
    - `establishmentLegalRegistrationNumber` string — The legal registration number of the establishment/location of the merchant. If omitted and the country code is FR, this defaults to the CoC number.
    - `vat` Vat — unresolved $ref
    - `countryCode` CountryCode — unresolved $ref
    - `contactPhone` string, phone — The primary contact phone number of the merchant.
    - `contactEmail` string, email — The primary contact email address of the merchant.
    - `website` string, uri — The website.
    - `companyTypeId` CompanyTypeId — unresolved $ref
    - `contractLanguage` ContractLanguage — unresolved $ref
    - `visitAddress` object
      - `code` string — Company address code (CA-code). When provided, the address fields are ignored.
      - `streetName` StreetName — unresolved $ref
      - `streetNumber` StreetNumber — unresolved $ref
      - `zipCode` ZipCode — unresolved $ref
      - `city` City — unresolved $ref
      - `countryCode` CountryCode — unresolved $ref
    - `postalAddress` object
      - `code` string — Company address code (CA-code). When provided, the address fields are ignored.
      - `streetName` StreetName — unresolved $ref
      - `streetNumber` StreetNumber — unresolved $ref
      - `zipCode` ZipCode — unresolved $ref
      - `city` City — unresolved $ref
      - `countryCode` CountryCode — unresolved $ref
    - `suspendedAt` SuspendedAt — unresolved $ref
    - `reviewRequest` object
      - `reason` string
      - `indicator` 'RISK' | 'COMPLIANCE'
      - `settlement` 'OFF'

## Response `200`

Ok.

- object
  - `code` Code — unresolved $ref
  - `name` Name — unresolved $ref
  - `publicName` PublicName — unresolved $ref
  - `boardingStatus` BoardingStatus — unresolved $ref
  - `status` Status — unresolved $ref
  - `payoutStatus` PayoutStatus — unresolved $ref
  - `coc` Coc — unresolved $ref
  - `vat` Vat — unresolved $ref
  - `companyTypeId` CompanyTypeId — unresolved $ref
  - `countryCode` CountryCode — unresolved $ref
  - `contractLanguage` ContractLanguage — unresolved $ref
  - `contractPackageCode` ContractPackageCode — unresolved $ref
  - `currentProfileCode` CurrentProfileCode — unresolved $ref
  - `contractPackage` ContractPackage — unresolved $ref
  - `contactPhone` string, phone — The primary contact phone number of the merchant.
  - `contactEmail` string, email — The primary contact email address of the merchant.
  - `website` Website — unresolved $ref
  - `postalAddress` PostalAddress — unresolved $ref
  - `visitAddress` VisitAddress — unresolved $ref
  - `partner` Partner — unresolved $ref
  - `createdAt` CreatedAt — unresolved $ref
  - `createdBy` CreatedBy — unresolved $ref
  - `acceptedAt` AcceptedAt — unresolved $ref
  - `suspendedAt` SuspendedAt — unresolved $ref
  - `suspendedBy` SuspendedBy — unresolved $ref
  - `modifiedAt` ModifiedAt — unresolved $ref
  - `modifiedBy` ModifiedBy — unresolved $ref
  - `deletedAt` DeletedAt — unresolved $ref
  - `deletedBy` DeletedBy — unresolved $ref
  - `reviewedAt` ReviewedAt — unresolved $ref
  - `nextReviewDate` NextReviewDate — unresolved $ref

## 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
- `422` — Unprocessable Entity, see response body for more information
- `429` — Rate limit reached.
- `500` — An internal error occurred

---

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