Skip to main content
DELETE
/
marketplace
/
merchants
/
{merchantId}
curl -X DELETE https://api.khaime.com/api/v1/partner/marketplace/merchants/1676 \
  -H "X-API-Key: pk_live_your_key"

​
Remove Merchant

Suspends a sub-merchant from your marketplace. The relationship record is set to suspended and the merchant’s marketplace assignment is cleared — it is not permanently deleted. A suspended merchant can be reactivated later.

​
Path Parameters

​
merchantId
string
required
The business ID of the sub-merchant to suspend.

​
Response

{
  "success": true,
  "message": "Merchant removed from marketplace"
}

​
Behavior

Only merchants with an active relationship to your marketplace can be suspended. The following changes happen atomically:
  • The MarketplaceMerchant record status is set to suspended.
  • The merchant’s portfolio marketplace_id and marketplace_commission_rate are cleared.
The merchant’s Khaime account, products, and transaction history are not affected.
To restore a suspended merchant, use the Reactivate Merchant endpoint. To permanently remove a merchant’s data, use the Delete Merchant endpoint.

​
Error Codes

StatusErrorFix
401UnauthorizedProvide a valid X-API-Key header
403This endpoint is restricted to marketplace operatorsYour account must have marketplace mode enabled
404Active merchant relationship not foundThe merchant is not actively linked to your marketplace or is already suspended
curl -X DELETE https://api.khaime.com/api/v1/partner/marketplace/merchants/1676 \
  -H "X-API-Key: pk_live_your_key"