curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Northstar Goods Marketplace",
    "business_email": "hello@northstargoods.example",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://northstargoods.example",
    "business_description": "Curated fashion marketplace",
    "commission_rate": 0.08
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "notification_config": {
      "send_sub_merchant_notifications": false
    }
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_description": "Curated fashion marketplace",
    "notification_config": {
      "send_sub_merchant_notifications": true,
      "send_buyer_notifications": true
    }
  }'

PATCH

marketplace

settings

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Northstar Goods Marketplace",
    "business_email": "hello@northstargoods.example",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://northstargoods.example",
    "business_description": "Curated fashion marketplace",
    "commission_rate": 0.08
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "notification_config": {
      "send_sub_merchant_notifications": false
    }
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_description": "Curated fashion marketplace",
    "notification_config": {
      "send_sub_merchant_notifications": true,
      "send_buyer_notifications": true
    }
  }'

Update Marketplace Settings

Update your marketplace’s public business details, default commission rate, and marketplace-level notification preferences. Send only the fields you want to change.

Request Body

At least one field is required.

business_name

string

Marketplace business name.

business_email

string

Marketplace public email address. This must be unique across Khaime accounts.

business_phone

string

Marketplace public phone number.

business_country

string

Marketplace country name or country value stored on the business account.

business_country_code

string

2-letter ISO country code, for example NG, US, or GB.

business_website

string

Marketplace website URL.

business_description

string

Public marketplace description.

commission_rate

number

Default commission rate for the marketplace, expressed as a decimal between 0 and 1. For example, send 0.08 for 8%.

notification_config

object

Marketplace payment notification settings. When provided, include at least one setting.

Show notification_config fields

send_sub_merchant_notifications

boolean

Whether to send payment receipt emails to sub-merchants after successful marketplace charges. Defaults to true when not set.

send_buyer_notifications

boolean

Whether to send payment confirmation emails to buyers after successful marketplace charges. Defaults to true when not set.

Response

{
  "success": true,
  "message": "Marketplace settings updated successfully",
  "data": {
    "marketplace": {
      "business_name": "Northstar Goods Marketplace",
      "business_email": "hello@northstargoods.example",
      "business_phone": "+2348012345678",
      "business_country": "Nigeria",
      "business_country_code": "NG",
      "business_website": "https://northstargoods.example",
      "business_description": "Curated fashion marketplace",
      "commission_rate": 0.08
    },
    "notification_config": {
      "send_sub_merchant_notifications": true,
      "send_buyer_notifications": true
    }
  }
}

Behavior

Profile and commission fields are partial updates. Omitted fields are left unchanged. notification_config is merged with the existing config, so you can update one notification setting without affecting the other. Unset notification keys default to true at send time. commission_rate here updates the marketplace default commission rate. To override commission for a specific sub-merchant, use Update Merchant.

Notification settings apply only to marketplace charges and affect Stripe, Paystack, and StartButton webhook processing from the next successful payment event onward.

Error Codes

Status	Error	Fix
`400`	`At least one marketplace setting must be provided`	Include at least one supported field
`400`	`"notification_config" must contain at least one setting`	Include at least one key in `notification_config`
`400`	`commission_rate must be between 0 and 1`	Use a decimal value, for example `0.10` for 10%
`400`	`business_email must be a valid email`	Send a valid email address
`400`	`business_email is already in use`	Use an email address that is not already tied to another Khaime account
`401`	`Unauthorized`	Provide a valid `X-API-Key` header
`403`	`This endpoint is restricted to marketplace operators`	Your account must have marketplace mode enabled

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Northstar Goods Marketplace",
    "business_email": "hello@northstargoods.example",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://northstargoods.example",
    "business_description": "Curated fashion marketplace",
    "commission_rate": 0.08
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "notification_config": {
      "send_sub_merchant_notifications": false
    }
  }'

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/settings \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_description": "Curated fashion marketplace",
    "notification_config": {
      "send_sub_merchant_notifications": true,
      "send_buyer_notifications": true
    }
  }'

Get Product Variants B2B Commerce Overview

API Reference

Account

Products & Pricing

Payments

Subscriptions

Marketplace

B2B Commerce

Update Marketplace Settings

Update Marketplace Settings

Request Body

Response

Behavior

Error Codes

​Update Marketplace Settings

​Request Body

​Response

​Behavior

​Error Codes

Update Marketplace Settings

Request Body

Response

Behavior

Error Codes