> ## Documentation Index
> Fetch the complete documentation index at: https://docs.khaime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reject Merchant Payout

> Reject a pending payout request and release its reserved balance.

# 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.

Authenticate with your marketplace operator Partner API key via the `X-API-Key` header. The key's environment (sandbox or live) determines which payout requests are visible.

## Path Parameters

<ParamField path="merchantId" type="number" required>
  The business ID of the requesting sub-merchant.
</ParamField>

<ParamField path="reference" type="string" required>
  The reference returned when the sub-merchant created the request.
</ParamField>

## Request Body

<ParamField body="reason" type="string" required>
  A reason between 3 and 500 characters.
</ParamField>

## Response

```json theme={null}
{
  "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"
  }
}
```

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.khaime.com/api/v1/partner/marketplace/merchants/1676/payouts/marketplace_payout_request_1780912800000_1676/reject" \
    -H "X-API-Key: pk_live_your_key" \
    -H "Content-Type: application/json" \
    -d '{"reason":"Payout requires additional merchant verification."}'
  ```
</RequestExample>

## Related

* [List Payout Requests](/api-reference/marketplace/list-payout-requests)
* [Approve Merchant Payout](/api-reference/marketplace/approve-payout)