---
title: "Update Submerchant"
method: PUT
path: "/api/v1/submerchant"
tags: ["Sub Merchant Operations"]
---

# Update Submerchant

`PUT /api/v1/submerchant`

You can update submerchants via this api

## Request body

- SubMerchantUpdateRequest
  - `application_key` string, required — It is the key of your application on our environment
  - `external_id` string, required — Unique id of sub merchant in your system
  - `name` string — Name of sub merchant
  - `type` 'Individual' | 'PersonalCompany' | 'Company', required — An enumeration.
  - `currency` string — Transfer currency, its default is TRY
  - `tax_number` string, required — Identity number for individuals, tax number for companies
  - `tax_office` string — Tax office of sub merchant.
  - `title` string — Title of sub merchant.
  - `gsm_number` string — GSM number of sub merchant.
  - `email` string, required — Email address of sub merchant.
  - `contact_name` string — It is required for individuals.
  - `contact_surname` string — It is required for individuals.
  - `iban` string, required — IBAN of submerchant. For individuals it must be suitable with contact name and contact surname. For companies it must be suitable with title.
  - `address` string, required — Address of sub merchant
  - `merchant_name` string, required — Settlement description template
  - `language` string — Its default value is tr. If you want to get messages in other languages, please send it. You can find supported languages in the api supported_languages.
  - `city` string — City Plate Code
  - `payment_due_day` integer — Payment due day

## Response `200`

Successful Response

- SubMerchantResponse
  - `response_code` string
  - `message` string
  - `submerchant_id` string
  - `detail` SubMerchant
    - `submerchant_id` string
    - `external_id` string
    - `merchant_name` string
    - `name` string
    - `type` 'Individual' | 'PersonalCompany' | 'Company' — An enumeration.
    - `currency` string
    - `tax_number` string
    - `tax_office` string
    - `title` string
    - `email` string
    - `gsm_number` string
    - `contact_name` string
    - `contact_surname` string
    - `iban` string
    - `address` string
    - `city` string
    - `payment_due_day` integer
  - `externals` SubMerchantExternalInfo[]
    - `payment_org` string
    - `external_status` 'Active' | 'Waiting' | 'Cancelled' — An enumeration.
  - `service_error_code` string
  - `service_error_message` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/jetcheckout/apis/jet-checkout.md) · [All operations](https://skmtc.dev/jetcheckout/apis/jet-checkout/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jetcheckout/jet-checkout/revisions/b17a3806ccb0/schema)