---
title: "Update Connect settings"
method: PATCH
path: "/api/connect/settings"
tags: ["Connect"]
---

# Update Connect settings

`PATCH /api/connect/settings`

Updates the calling marketplace's Connect settings. Only self-service fields are accepted; `connectEnabled` and `paused` are admin-only. If no settings row exists yet, one is created with platform defaults before applying the patch.

## Request body

- UpdateMarketplaceSettingsApiDto
  - `marketplaceFeeRatePer1000` number — Marketplace take rate on the gross payin amount. Effective rate = value / 100_000 (same scale as User.payinFeeRatePer1000). Examples: 2500 = 2.5%, 1000 = 1%, 250 = 0.25%. Capped at 10000 (10%).
  - `marketplaceFeeFixedInCents` number — Flat marketplace fee in cents charged on every payin.
  - `marketplaceFeeBearer` 'SUB_MERCHANT' | 'MARKETPLACE' — "SUB_MERCHANT" (default) creates an obligation per payin. "MARKETPLACE" means no obligation is created — the marketplace absorbs the fee on its own margin.
  - `marketplaceDepositFeeRatePer1000` number — Marketplace take rate on virtual-account deposits. Effective rate = value / 100_000 (same scale as marketplaceFeeRatePer1000). Applied to the deposit amount.
  - `marketplaceDepositFeeFixedInCents` number — Flat marketplace fee in cents charged on every deposit.
  - `payoutWindowHours` number — Cooldown in hours during which an incoming payin amount is locked against withdrawal. 0 disables the window (instant availability).
  - `payoutWindowMaxReleaseRate` number — Per1000 of in-window payin amount that can be released early (1000 = 100% fully locked, 0 = fully released).
  - `payoutFeeBearer` 'MARKETPLACE' | 'SUB_MERCHANT' — Default bearer of payout fees when sub-merchants withdraw. Can be overridden per-payout on the payout request.
  - `autoCreateWallets` boolean — When true, sub-merchant wallets are provisioned automatically on KYC approval. When false, wallets are created lazily on first split.
  - `enabledCurrencies` string[] — Stablecoins sub-merchants can receive and withdraw.
  - `defaultRedirectUrlKyc` string, uri — Default URL where sub-merchants are redirected after completing KYC. Can still be overridden per createConnectAccount call.

## Response `200`

- MarketplaceSettingsApiDto
  - `id` string, required
  - `marketplaceUserId` string, required
  - `marketplaceFeeRatePer1000` number, required
  - `marketplaceFeeFixedInCents` number, required
  - `marketplaceFeeBearer` 'SUB_MERCHANT' | 'MARKETPLACE', required
  - `marketplaceDepositFeeRatePer1000` number, required
  - `marketplaceDepositFeeFixedInCents` number, required
  - `payoutWindowHours` number, required
  - `payoutWindowMaxReleaseRate` number, required
  - `payoutFeeBearer` 'MARKETPLACE' | 'SUB_MERCHANT', required
  - `autoCreateWallets` boolean, required
  - `enabledCurrencies` string[], required
  - `defaultRedirectUrlKyc` string, nullable, required
  - `connectEnabled` boolean, required — Managed by Inflow. False means the Connect surface is disabled for this marketplace (all Connect endpoints return 403).
  - `paused` boolean, required — Managed by Inflow. True means fee collection + payouts are temporarily paused (e.g. compliance hold).
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Invalid input data
- `401` — Unauthorized - Invalid API key

---

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