curl -X PATCH https://api.khaime.com/api/v1/marketplace/merchants/892/commission \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{"commission_rate": 0.08}'

PATCH

marketplace

merchants

{merchantId}

commission

curl -X PATCH https://api.khaime.com/api/v1/marketplace/merchants/892/commission \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{"commission_rate": 0.08}'

Update Commission

Set a per-merchant commission rate that overrides your marketplace’s default rate for this sub-merchant only. This is the rate used when Create Charge resolves how much to deduct from a marketplace split.

Commission resolution order at charge time: this per-merchant rate → your portfolio’s marketplace_commission_rate default → 0 if neither is set.

Path Parameters

integer

required

The sub-merchant’s business ID (merchant_id from List Merchants).

Request Body

number

required

Decimal commission rate between 0 and 1 (e.g. 0.08 = 8%). Not a percentage — 8 is invalid, 0.08 is correct.

Response

{
  "success": true,
  "message": "Commission rate updated successfully",
  "data": {
    "commission_rate": 0.08
  }
}

Updates both the marketplace-merchant relationship’s rate and the sub-merchant’s BusinessPortfolio.marketplace_commission_rate — the latter is what Create Charge actually reads at split time.

Error Codes

Status	Error Code	Cause
`403`	`AUTH_PERMISSION_DENIED`	Your business isn’t set up as a marketplace operator. Run Setup Marketplace first.
`400`	`VALIDATION_FAILED`	`commission_rate` is missing, or outside the `0`–`1` range.
`404`	`BUSINESS_NOT_FOUND`	No active `MarketplaceMerchant` relationship exists for `merchantId` under your marketplace. Pending or suspended relationships return this same error — reactivate via Link Merchant first.
`400`	`INTERNAL_ERROR`	Unexpected server error.

curl -X PATCH https://api.khaime.com/api/v1/marketplace/merchants/892/commission \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{"commission_rate": 0.08}'

API Reference

Account

Products & Pricing

Payments

Integration Guides

Commerce API

Subscriptions

Marketplace

Update Commission

Update Commission

Path Parameters

Request Body

Response

Error Codes

​Update Commission

​Path Parameters

​Request Body

​Response

​Error Codes

Update Commission

Path Parameters

Request Body

Response

Error Codes