---
title: "Process Reward Payout"
method: PATCH
path: "/api/client-referrals/{referral_id}/reward"
tags: ["client-referrals"]
---

# Process Reward Payout

`PATCH /api/client-referrals/{referral_id}/reward`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/client-referrals/{referral_id}/reward`
- Auth: HTTP bearer

Process reward payout (founder only)

## Path parameters

- `referral_id` string, required

## Request body

- RewardPayoutRequest: Request to process reward payout
  - `reward_status` 'Approved', required: Must be 'Approved'
  - `payout_method` 'stripe_transfer' | 'invoice_credit', required: Payout method
  - `notes` string, nullable: Admin notes

## Response `200`

Successful Response

- RewardPayoutResponse: Response after processing reward
  - `referral_id` string, required
  - `reward_amount` number, required
  - `reward_status` string, required
  - `reward_payment_id` string, required
  - `paid_date` string, date-time, required
  - `payout_method` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)
