> For the complete documentation index, see [llms.txt](https://help.unitpay.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.unitpay.ru/payouts/payout_list.md).

# Список выплат (API)

С помощью этого запроса вы получите список своих массовых выплат за период. По каждой выплате возвращаются статус, сумма, комиссии, сумма списания с баланса и валюта счета. Запрос подходит для сверки выплат.

{% hint style="info" %}
Запрос только читает данные и не уточняет статусы в платежных системах. Чтобы обновить статус конкретной выплаты, используйте запрос ["Информация о выплате"](https://help.unitpay.ru/payouts/payout_info).
{% endhint %}

```bash
GET https://unitpay.ru/api

method      = massPaymentList
login       = partner@gmail.com
secretKey   = sk_live_2YQt9m
dateFrom    = 2026-09-01
dateTo      = 2026-09-30
status      = success,error
paymentType = card,sbp
limit       = 100
```

**Обязательные параметры:**

<table data-header-hidden><thead><tr><th width="160">name</th><th width="120">type</th><th>description</th></tr></thead><tbody><tr><td><strong>login</strong></td><td>строка</td><td>Email аккаунта в системе UnitPay</td></tr><tr><td><strong>secretKey</strong></td><td>строка</td><td>Секретный ключ аккаунта, доступен в <a href="https://unitpay.ru/partner/profile/edit">настройках профиля</a></td></tr></tbody></table>

**Дополнительные параметры:**

<table data-header-hidden><thead><tr><th width="160">name</th><th width="120">type</th><th>description</th></tr></thead><tbody><tr><td><strong>dateFrom</strong></td><td>строка</td><td>Начало периода по дате создания выплаты в формате ГГГГ-ММ-ДД. По умолчанию — за 29 дней до dateTo</td></tr><tr><td><strong>dateTo</strong></td><td>строка</td><td>Конец периода включительно в формате ГГГГ-ММ-ДД. По умолчанию — текущая дата</td></tr><tr><td><strong>status</strong></td><td>строка</td><td>Статусы выплат через запятую: success, wait, not_completed, error</td></tr><tr><td><strong>paymentType</strong></td><td>строка</td><td>Коды платежных систем через запятую: card, sbp, webmoney, usdt, mc, qiwi, yandex</td></tr><tr><td><strong>projectId</strong></td><td>число</td><td>Уникальный ID проекта в системе UnitPay. В ответ попадут только выплаты, созданные с этим projectId</td></tr><tr><td><strong>limit</strong></td><td>число</td><td>Количество выплат в ответе: от 1 до 500, по умолчанию 100</td></tr><tr><td><strong>cursor</strong></td><td>число</td><td>Значение nextCursor из предыдущего ответа. Передается, чтобы получить следующую страницу</td></tr></tbody></table>

{% hint style="info" %}
Период считается целыми днями по московскому времени (UTC+3) и не может быть длиннее 31 дня. Чтобы получить выплаты за больший срок, запрашивайте их по месяцам.

Несколько значений в **status** и **paymentType** передаются одной строкой через запятую, например `status=success,error`.
{% endhint %}

Если для аккаунта задан список разрешенных IP-адресов, запрос принимается только с этих адресов.

#### Пример успешного ответа

```json
{
  "result": {
    "items": [
      {
        "payoutId":          325421263,
        "status":            "success",
        "payoutCommission":  "0.00",
        "partnerCommission": "24.75",
        "sum":               "450.00",
        "createDate":        "2026-09-30 14:02:11",
        "completeDate":      "2026-09-30 14:04:37",
        "transactionId":     "1782",
        "paymentType":       "sbp",
        "purse":             "79123456789",
        "debited":           "474.75",
        "paidOut":           "450.00",
        "currency":          "RUB",
        "projectId":         null,
        "comment":           null
      },
      {
        "payoutId":          325421190,
        "status":            "error",
        "payoutCommission":  "0.00",
        "partnerCommission": "30.00",
        "sum":               "1000.00",
        "createDate":        "2026-09-30 13:47:05",
        "completeDate":      "2026-09-30 13:47:52",
        "transactionId":     "1781",
        "paymentType":       "card",
        "purse":             "220070xxxxxx0004",
        "debited":           "1030.00",
        "paidOut":           null,
        "currency":          "RUB",
        "projectId":         null,
        "comment":           null
      }
    ],
    "nextCursor": 325421190
  }
}
```

<table data-header-hidden><thead><tr><th width="190">name</th><th width="120">type</th><th>description</th></tr></thead><tbody><tr><td><strong>items</strong></td><td>массив</td><td>Выплаты за период, от новых к старым</td></tr><tr><td><strong>nextCursor</strong></td><td>число</td><td>Значение для параметра cursor следующего запроса. null — это последняя страница</td></tr></tbody></table>

**Параметры выплаты:**

<table data-header-hidden><thead><tr><th width="190">name</th><th width="120">type</th><th>description</th></tr></thead><tbody><tr><td><strong>payoutId</strong></td><td>число</td><td>Уникальный ID выплаты в системе UnitPay</td></tr><tr><td><strong>transactionId</strong></td><td>строка</td><td>Уникальный ID выплаты на стороне партнера</td></tr><tr><td><strong>status</strong></td><td>строка</td><td>success — успешная выплата<br>wait — выплата в обработке<br>not_completed — выплата отправлена в платежную систему, но еще не получено подтверждение (временный статус)<br>error — ошибочная выплата</td></tr><tr><td><strong>sum</strong></td><td>число</td><td>Сумма выплаты</td></tr><tr><td><strong>payoutCommission</strong></td><td>число</td><td>Комиссия с выплаты</td></tr><tr><td><strong>partnerCommission</strong></td><td>число</td><td>Комиссия с партнера</td></tr><tr><td><strong>debited</strong></td><td>число</td><td>Сумма, списанная с баланса при создании выплаты: sum + partnerCommission, в валюте currency. По выплате в статусе error эта сумма возвращается на баланс</td></tr><tr><td><strong>paidOut</strong></td><td>число</td><td>Сумма, которую получил получатель. Передается только для выплат в статусе success, в остальных случаях null</td></tr><tr><td><strong>currency</strong></td><td>строка</td><td>Валюта счета, с которого списана выплата: RUB или USDT</td></tr><tr><td><strong>paymentType</strong></td><td>строка</td><td>Код платежной системы выплаты. null, если выплата сделана способом, которого нет среди значений параметра paymentType</td></tr><tr><td><strong>purse</strong></td><td>строка</td><td>Реквизит получателя. Номер карты передается в маскированном виде: первые 6 и последние 4 цифры</td></tr><tr><td><strong>projectId</strong></td><td>число</td><td>ID проекта, если выплата создана с параметром projectId, иначе null</td></tr><tr><td><strong>comment</strong></td><td>строка</td><td>Комментарий к выплате, переданный при создании</td></tr><tr><td><strong>createDate</strong></td><td>строка</td><td>Дата создания выплаты, UTC+3</td></tr><tr><td><strong>completeDate</strong></td><td>строка</td><td>Дата последнего изменения выплаты, UTC+3</td></tr></tbody></table>

Суммы передаются строкой с двумя знаками после точки.

#### Получение следующих страниц

1. Первый запрос отправьте без параметра **cursor**.
2. Если в ответе **nextCursor** не равен null, повторите запрос с теми же параметрами и добавьте `cursor` со значением **nextCursor**.
3. Если **nextCursor** равен null, получена последняя страница.

{% hint style="success" %}
Выплаты, созданные во время обхода, в него не попадут и страницы не сдвинут: повторов и пропусков не будет. Статус выплаты может измениться после получения списка, поэтому выплаты в статусах wait и not\_completed запросите повторно позже.
{% endhint %}

#### Пример ошибочного ответа

```json
{
    "error": {
        "message": "Период с dateFrom по dateTo должен быть от 1 до 31 дня",
        "code": -32602
    }
}
```

<table data-header-hidden><thead><tr><th width="160">name</th><th>description</th></tr></thead><tbody><tr><td><strong>-32000</strong></td><td>Неверные параметры авторизации (логин, секретный ключ), запрос с IP-адреса вне списка разрешенных или projectId не принадлежит аккаунту</td></tr><tr><td><strong>-32602</strong></td><td>Неверные параметры запроса: формат даты, период длиннее 31 дня или dateFrom позже dateTo, неизвестное значение status или paymentType, limit вне диапазона от 1 до 500, параметр передан массивом</td></tr></tbody></table>