Skip to main content
POST
/
marketplace
/
merchants
/
{merchantId}
/
payouts
/
{reference}
/
reject
curl -X POST \
  "https://api.khaime.com/api/v1/marketplace/merchants/1676/payouts/marketplace_payout_request_1780912800000_1676/reject" \
  -H "x-id-key: your_dashboard_auth_token" \
  -H "X-Environment: live" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Payout requires additional merchant verification."}'

​
Reject Merchant Payout

Reject a staged payout request that should not proceed to Khaime admin settlement. Rejection releases the logical balance reservation, allowing the sub-merchant to submit another request. This dashboard endpoint uses x-id-key authentication, not a Partner API key.

​
Path Parameters

​
merchantId
number
required
The business ID of the requesting sub-merchant.
​
reference
string
required
The reference returned when the sub-merchant created the request.

​
Request Body

​
reason
string
required
A reason between 3 and 500 characters.

​
Response

{
  "success": true,
  "message": "Sub-merchant payout request rejected. Reserved funds have been released.",
  "data": {
    "payout_request_id": 9821,
    "merchant_id": 1676,
    "reference": "marketplace_payout_request_1780912800000_1676",
    "status": "rejected",
    "rejection_reason": "Payout requires additional merchant verification.",
    "rejected_at": "2026-06-08T10:15:00.000Z"
  }
}

curl -X POST \
  "https://api.khaime.com/api/v1/marketplace/merchants/1676/payouts/marketplace_payout_request_1780912800000_1676/reject" \
  -H "x-id-key: your_dashboard_auth_token" \
  -H "X-Environment: live" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Payout requires additional merchant verification."}'