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."}'

POST

marketplace

merchants

{merchantId}

payouts

{reference}

reject

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."}'

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

number

required

The business ID of the requesting sub-merchant.

string

required

The reference returned when the sub-merchant created the request.

Request Body

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/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."}'

Approve Merchant Payout List Merchants

API Reference

Account

Products & Pricing

Payments

Subscriptions

Marketplace

Reject Merchant Payout

Reject Merchant Payout

Path Parameters

Request Body

Response

​Reject Merchant Payout

​Path Parameters

​Request Body

​Response

​Related

Reject Merchant Payout

Path Parameters

Request Body

Response

Related