---
title: "Record one manual payout for one affiliate (spec 4.6)."
method: POST
path: "/api/v1/admin/affiliates/{affiliate_id}/payouts"
tags: ["Affiliate Admin"]
---

# Record one manual payout for one affiliate (spec 4.6).

`POST /api/v1/admin/affiliates/{affiliate_id}/payouts`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/admin/affiliates/{affiliate_id}/payouts`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

<br/>v1 pays by hand: the admin has already sent the PayPal or bank transfer<br/>and is recording it with its reference, so the payout is created `paid`<br/>and every commission it covers flips to `paid` in the same transaction.<br/>A balance below PAYOUT_MINIMUM_CENTS, negative balances included, is a<br/>422 that writes nothing and rolls into the next run (R11).

## Path parameters

- `affiliate_id` integer, required

## Request body

- AdminPayoutRunRequest: One manual payout run for one affiliate (spec 4.6, R11). `reference` is required. The run records a transfer that already left the account, so the PayPal or bank transfer id is the only thing that ties the ledger row back to the statement.
  - `method` string, required
  - `note` string, nullable
  - `period_end` string, date, required
  - `period_start` string, date, required
  - `reference` string, required

## Response `201`

Created

- PayoutItem
  - `amount_cents` integer, required
  - `currency` string, required
  - `id` integer, required
  - `method` string, required
  - `note` string, nullable
  - `paid_at` string, date-time, nullable
  - `period_end` string, date, required
  - `period_start` string, date, required
  - `reference` string, nullable
  - `status` string, required

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)