---
title: "Merchant: Update"
method: PATCH
path: "/merchants/{id}"
tags: ["Platform Model"]
---

# Merchant: Update

`PATCH /merchants/{id}`

Updates a sub-merchant's settings, including payment and payout toggles, email notification preferences, and payment method expiry settings.

## Path parameters

- `id` string, required — A unique 25-character alphanumeric resource identifier.

## Request body

- object
  - `payments_enabled` boolean
  - `payouts_enabled` boolean
  - `send_payment_instruction_email` boolean
  - `send_payment_receipt_email` boolean
  - `send_payment_reminder_email` boolean
  - `send_payment_capture_email` boolean
  - `send_payment_refund_email` boolean
  - `expiry_settings` object[]
    - `slug` 'bank_transfer' | 'konbini'
    - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND' — 3-letter ISO currency code.
    - `expiry_days` integer, required

## Response `200`

200 response

- SerializedSubmerchant
  - `id` string, required — Unique identifier for this sub-merchant.
  - `live` boolean, required — Whether this merchant is operating in live (production) mode.
  - `created_at` string, date-time, required — Timestamp when this merchant was created.
  - `updated_at` string, date-time, required — Timestamp when this merchant record was last updated.
  - `account_id` string, required — Account identifier associated with this merchant.
  - `name` string, required — Display name of the sub-merchant.
  - `platform_role` 'seller' | 'payout', required
  - `status` string, required — Current account/application status of the merchant.
  - `payments_enabled` boolean, required — Whether payments are currently enabled for this merchant.
  - `payouts_enabled` boolean, required — Whether payouts are currently enabled for this merchant.
  - `send_payment_instruction_email` boolean — Whether payment instruction emails are sent to customers for this merchant. Omitted for `payout`-role merchants.
  - `send_payment_receipt_email` boolean — Whether payment receipt emails are sent to customers for this merchant. Omitted for `payout`-role merchants.
  - `send_payment_reminder_email` boolean — Whether payment reminder emails are sent to customers for this merchant. Omitted for `payout`-role merchants.
  - `send_payment_refund_email` boolean — Whether refund notification emails are sent to customers for this merchant. Omitted for `payout`-role merchants.
  - `expiry_settings` object[], required
    - `name` string, required — Human-readable name of the payment method this expiry setting applies to.
    - `slug` string, required — Machine-readable slug identifying the payment method.
    - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
    - `expiry_days` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `default_expiry_days` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
  - `active_payment_methods` object[], required
    - `name` string, required — Human-readable name of the payment method.
    - `type` string, required — Machine-readable type slug for the payment method.
    - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
    - `percentage` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `fixed_amount_cents` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
    - `minimum_processing_fee_amount_cents` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
  - `publishable_key` string, required — The merchant's publishable API key for client-side use.

---

[API](https://skmtc.net/komoju/apis/komoju-api.md) · [All operations](https://skmtc.net/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komoju/komoju-api/versions/65483c40ba32/schema)