---
title: "Update a submerchant"
method: PATCH
path: "/submerchants/{submerchantId}"
tags: ["Submerchants"]
---

# Update a submerchant

`PATCH /submerchants/{submerchantId}`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

## Path parameters

- `submerchantId` string, required

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Request body

- UpdateSubmerchantDto
  - `name` string: Name of the submerchant
  - `description` string: Description of the submerchant
  - `address` string: Address of the submerchant
  - `zipcode` string: Zipcode of the submerchant
  - `city` string: City of the submerchant
  - `phoneNumber` string: Phone number of the submerchant
  - `legalInfo` SubmerchantLegalInfoDto
    - `legalName` string: Legal name
    - `headOfficeAddress` string: Legal head office address
    - `businessActivity` string: Business activity
    - `managerName` string: Manager name
    - `websiteURL` string: Website URL
    - `isBetting` boolean: Is betting
    - `isCrypto` boolean: Is crypto
    - `isNGO` boolean: Is NGO

## Response `200`

Submerchant updated successfully

- SubmerchantResponseDto
  - `id` string, required: Identifier of the submerchant
  - `name` string, required: Name of the submerchant
  - `description` string: Description of the submerchant
  - `status` 'closed' | 'live' | 'sandbox' | 'suspended' | 'testing' | 'initialized', required: Status of the submerchant
  - `isActive` boolean, required: Whether the submerchant is active
  - `isAggregator` boolean, required: Whether the submerchant is an aggregator
  - `defaultCurrency` string, required: Default currency of the submerchant, ISO 4217
  - `country` string: Country of the submerchant, ISO 3166-1 alpha-2
  - `address` string: Address of the submerchant
  - `zipcode` string: Zipcode of the submerchant
  - `city` string: City of the submerchant
  - `phoneNumber` string: Phone number of the submerchant
  - `legalInfo` SubmerchantLegalInfoDto
    - `legalName` string: Legal name
    - `headOfficeAddress` string: Legal head office address
    - `businessActivity` string: Business activity
    - `managerName` string: Manager name
    - `websiteURL` string: Website URL
    - `isBetting` boolean: Is betting
    - `isCrypto` boolean: Is crypto
    - `isNGO` boolean: Is NGO
  - `createdAt` string, required: Creation date of the submerchant, ISO 8601

## Other responses

- `400`: Bad Request
- `401`: Wrong credentials
- `404`: Not Found
- `500`: Internal error

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/submerchants/:submerchantId/patch.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)