SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-09
Browse: SET Merchant API

SET Merchant API · Payout controls

Reject a payout

POST/v1/payouts/{id}/reject

Key scope: read

Rejects a payout waiting for approval: it becomes rejected and nothing is sent. Needs the approve scope. Event payout.rejected.

Path parameters

id stringrequired
The payout's id.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Errors

  • 403 scope_missing
  • 403 operator_cannot_approve
  • 404 payout_unknown
  • 409 payout_not_pending_approval
  • 409 payout_moved
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.