curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/merchants/1676 \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Sub Store",
    "business_email": "merchant@example.com",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://substore.example.com",
    "business_description": "Premium local fashion merchant",
    "commission_rate": 0.12
  }'

PATCH

marketplace

merchants

{merchantId}

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/merchants/1676 \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Sub Store",
    "business_email": "merchant@example.com",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://substore.example.com",
    "business_description": "Premium local fashion merchant",
    "commission_rate": 0.12
  }'

Update Merchant

Update basic information for a sub-merchant linked to your marketplace. You can also update this marketplace’s commission rate for that specific merchant.

Path Parameters

merchantId

string

required

The business ID of the sub-merchant to update.

Request Body

At least one field is required.

business_name

string

Sub-merchant business name.

business_email

string

Sub-merchant email address. This must be unique across Khaime accounts.

business_phone

string

Sub-merchant public phone number.

business_country

string

Sub-merchant 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

Sub-merchant website URL.

business_description

string

Public sub-merchant description.

commission_rate

number

Commission rate for this marketplace-merchant relationship, expressed as a decimal between 0 and 1. For example, send 0.12 for 12%.

Response

{
  "success": true,
  "message": "Merchant updated successfully",
  "data": {
    "merchant": {
      "id": 1676,
      "business_name": "Sub Store",
      "business_email": "merchant@example.com",
      "business_phone": "+2348012345678",
      "business_country": "Nigeria",
      "business_country_code": "NG",
      "business_website": "https://substore.example.com",
      "business_description": "Premium local fashion merchant",
      "commission_rate": 0.12
    }
  }
}

Behavior

This endpoint only updates merchants that are actively linked to your marketplace. Profile fields update the sub-merchant’s Khaime business profile and public portfolio fields. commission_rate updates the commission override for this specific marketplace-merchant relationship.

Use Update Marketplace Settings when you want to update the marketplace’s own profile or default commission rate. Use this endpoint when the change belongs to one sub-merchant.

Error Codes

Status	Error	Fix
`400`	`At least one merchant setting must be provided`	Include at least one supported field
`400`	`merchantId must be a valid sub-merchant business id`	Use the sub-merchant business ID
`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
`404`	`Active merchant relationship not found`	The merchant is not actively linked to your marketplace
`404`	`Sub-merchant account not found`	The merchant account or portfolio could not be found

curl -X PATCH https://api.khaime.com/api/v1/partner/marketplace/merchants/1676 \
  -H "X-API-Key: pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Sub Store",
    "business_email": "merchant@example.com",
    "business_phone": "+2348012345678",
    "business_country_code": "NG",
    "business_website": "https://substore.example.com",
    "business_description": "Premium local fashion merchant",
    "commission_rate": 0.12
  }'

Get Merchant Details Remove Merchant

API Reference

Account

Products & Pricing

Payments

Subscriptions

Marketplace

B2B Commerce

Update Merchant

Update Merchant

Path Parameters

Request Body

Response

Behavior

Error Codes

​Update Merchant

​Path Parameters

​Request Body

​Response

​Behavior

​Error Codes

Update Merchant

Path Parameters

Request Body

Response

Behavior

Error Codes