API: выплаты

Эндпоинты выплат MeerPartners: создание заявки на вывод POST /api/v1/payouts и история GET /api/v1/payouts, статусы заявок и коды ошибок.

Группа /api/v1/payouts/* — вывод средств инфлюенсером. Все эндпоинты требуют JWT инфлюенсера; affiliate_id берётся из токена (анти-IDOR). Заявка создаётся мгновенно в статусе requested, а обработка провайдером идёт асинхронно — эндпоинт не блокируется на платёжном шлюзе. Метод вывода предварительно добавляется через Affiliate API.

POST /api/v1/payouts

Создать заявку на вывод. Сумма резервируется: соответствующие комиссии переходят из payable в locked. Успех — 202 Accepted.

{ "payout_method_id": 301, "currency": "RUB", "amount": "12400.00" }

{
  "payout_id": 4501,
  "amount": "12400.00",
  "currency": "RUB",
  "status": "requested"
}

GET /api/v1/payouts

История выплат инфлюенсера. Возвращает массив заявок (от новых к старым).

[
  {
    "id": 4501,
    "amount": "12400.00",
    "currency": "RUB",
    "status": "paid",
    "provider": "manual",
    "requested_at": "2026-06-10T09:00:00Z",
    "paid_at": "2026-06-11T14:20:00Z"
  },
  {
    "id": 4498,
    "amount": "85.00",
    "currency": "USD",
    "status": "processing",
    "provider": "manual",
    "requested_at": "2026-06-12T08:00:00Z",
    "paid_at": null
  }
]

Статусы заявки

Жизненный цикл (FSM): requested → processing → paid (успех) или → failed. Заявка с подозрением на фрод может уйти в on_hold до ручной проверки. При failed зарезервированные комиссии возвращаются обратно в payable.

Коды ошибок

Что дальше