Skip to main content

​
Intro

Marketplace mode is the flag that unlocks every /marketplace/* endpoint for your business — it is provisioned by Khaime, not something you turn on yourself through the Partner API.

​
Context

There is no partner-callable “create marketplace” endpoint. Marketplace mode is enabled internally by Khaime against your existing business account — talk to your Khaime account contact to get it turned on. Once enabled, every other page in this section (Create Merchant, Link Merchant, Import Merchants, List Merchants, Marketplace Products, and so on) becomes available to your API key.
There is no separate “marketplace” object to create or fetch — your business ID doubles as the marketplace_id you’ll see throughout the other endpoints (for example in List Merchants and Get Merchant Details).

​
Hows

Enabling marketplace mode does two things to your business account:
  1. Flags your business as a marketplace operator, unlocking the /marketplace/* endpoints for your Partner API key.
  2. Optionally sets a default commission rate (a decimal between 0 and 1) applied to any sub-merchant that doesn’t have its own per-merchant override.
To get set up:
1

Contact Khaime

Reach out to your Khaime account contact and request marketplace mode for your business, including the default commission rate you want (if any).
2

Confirm it's active

Once enabled, call any operator-only endpoint — List Merchants is a good check. A 200 response means marketplace mode is active; a 403 with AUTH_PERMISSION_DENIED means it isn’t enabled yet.
3

Start onboarding merchants

Use Create Merchant, Link Merchant, or Import Merchants depending on whether each merchant already has a Khaime account.
4

Adjust your default rate later

Change your marketplace’s default commission rate at any time via Update Marketplace Settings. Per-merchant overrides are set via Update Commission.

​
Whys

Marketplace mode isn’t a cosmetic setting — it changes payment splitting, commission accounting, and payout eligibility logic for every charge that references a sub_merchant_id. Gating it behind Khaime provisioning means a business can’t accidentally (or maliciously) start operating as a marketplace operator over sub-merchants without Khaime’s compliance and support teams being aware, since marketplace operators take on responsibilities around merchant KYC and payout review that a normal single-business account doesn’t have.

​
Why nots

Don’t expect a POST /marketplace/setup call to work — it doesn’t exist for partners. If you’re building against these docs from an older integration guide or example that references such an endpoint, that reference is out of date. This page also isn’t where you configure per-merchant details — commission overrides, payout setup, and KYC are all handled per sub-merchant once marketplace mode is active and merchants are linked. See Update Commission and Get Merchant Details.