Skip to main content
DELETE

​
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

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

​
Response

​
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