---
title: "Список выплат"
method: GET
path: "/payouts"
tags: ["Выплаты"]
---

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

`GET /payouts`

Используйте этот запрос, чтобы получить список выплат. Для выгрузки доступны выплаты, созданные за последние 3 года. Список можно отфильтровать по различным критериям. Данные для аутентификации: https://yookassa.ru/developers/using-api/interaction-format#auth запросов зависят от того, какое платежное решение вы используете — обычные выплаты: https://yookassa.ru/developers/payouts/overview или выплаты в рамках Безопасной сделки: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics. Подробнее о работе со списками: https://yookassa.ru/developers/using-api/lists

## Query parameters

- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `created_at.lte` string, date-time
- `created_at.lt` string, date-time
- `payout_destination.type` 'yoo_money' | 'bank_card' | 'sbp' — Способ получения выплаты: yoo_money — выплаты на кошелек ЮMoney; bank_card — выплаты на банковскую карту; sbp — выплаты через СБП на счет в банке или платежном сервисе.
- `status` 'pending' | 'succeeded' | 'canceled' — Статус выплаты. Возможные значения: pending — выплата создана, но деньги еще не поступили на указанное платежное средство пользователя (например, ЮKassa ждет подтверждения от эквайера, что перевод успешен); succeeded — выплата успешно завершена, деньги переведены на платежное средство пользователя (финальный и неизменяемый статус); canceled — выплата отменена, инициатор и причина отмены указаны в объекте cancellation_details (финальный и неизменяемый статус).
- `limit` integer
- `cursor` string

## Response `200`

Запрос успешно обработан

- PayoutsList — Список выплат. Выплаты отсортированы по времени создания в порядке убывания (от новых к старым). Если результатов больше, чем задано в limit, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр next_cursor с указателем на следующий фрагмент.
  - `type` 'list', required — Формат выдачи результатов запроса. Возможное значение: list (список).
  - `items` Payout[], required
    - `id` string, required — Идентификатор выплаты.
    - `amount` object, required — Сумма выплаты.
      - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB.
    - `status` 'pending' | 'succeeded' | 'canceled', required — Статус выплаты. Возможные значения: pending — выплата создана, но деньги еще не поступили на указанное платежное средство пользователя (например, ЮKassa ждет подтверждения от эквайера, что перевод успешен); succeeded — выплата успешно завершена, деньги переведены на платежное средство пользователя (финальный и неизменяемый статус); canceled — выплата отменена, инициатор и причина отмены указаны в объекте cancellation_details (финальный и неизменяемый статус).
    - `payout_destination` union, required
      - PayoutToCardDestination — Платежное средство, на которое ЮKassa зачисляет выплату.
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required — Способ получения выплаты: bank_card – выплата на банковскую карту; yoo_money – выплата на кошелек ЮMoney; sbp – выплата через СБП на счет в банке или платежном сервисе.
        - `card` PayoutCardData — Данные банковской карты.
          - `first6` string, required — Первые 6 цифр номера карты (BIN).
          - `last4` string, required — Последние 4 цифры номера карты.
          - `card_type` 'MasterCard' | 'Visa' | 'Mir' | 'UnionPay' | 'JCB' | 'AmericanExpress' | 'DinersClub' | 'DiscoverCard' | 'InstaPayment' | 'InstaPaymentTM' | 'Laser' | 'Dankort' | 'Solo' | 'Switch' | 'Unknown', required — Тип банковской карты. Возможные значения: MasterCard (для карт Mastercard и Maestro), Visa (для карт Visa и Visa Electron), Mir, UnionPay, JCB, AmericanExpress, DinersClub, DiscoverCard, InstaPayment, InstaPaymentTM, Laser, Dankort, Solo, Switch и Unknown.
          - `issuer_country` string — Код страны, в которой выпущена карта. Передается в формате ISO-3166 alpha-2: https://www.iso.org/obp/ui/#iso:pub:PUB500001:en. Пример: RU.
          - `issuer_name` string — Наименование банка, выпустившего карту.
      - PayoutToYooMoneyDestination — Платежное средство, на которое ЮKassa зачисляет выплату.
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required — Способ получения выплаты: bank_card – выплата на банковскую карту; yoo_money – выплата на кошелек ЮMoney; sbp – выплата через СБП на счет в банке или платежном сервисе.
        - `account_number` string, required — Номер кошелька ЮMoney, например 41001614575714. Длина — от 11 до 33 цифр.
      - PayoutToSbpDestination — Платежное средство, на которое ЮKassa зачисляет выплату.
        - `type` 'bank_card' | 'yoo_money' | 'sbp', required — Способ получения выплаты: bank_card – выплата на банковскую карту; yoo_money – выплата на кошелек ЮMoney; sbp – выплата через СБП на счет в банке или платежном сервисе.
        - `phone` string, required — Телефон, к которому привязан счет получателя выплаты в системе участника СБП. Указывается в формате ITU-T E.164: https://ru.wikipedia.org/wiki/E.164, например 79000000000.
        - `bank_id` string, required — Идентификатор участника СБП — банка или платежного сервиса, подключенного к сервису.
        - `recipient_checked` boolean, required — Проверка получателя выплаты: https://yookassa.ru/developers/payouts/scenario-extensions/recipient-check: true — выплата проходила с проверкой получателя, false — выплата проходила без проверки получателя.
    - `description` string — Описание транзакции (не более 128 символов). Например: «Выплата по договору 37».
    - `created_at` string, date-time, required — Время создания выплаты. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. Пример: 2017-11-03T11:52:31.827Z
    - `succeeded_at` string, date-time — Время успешного проведения выплаты. Указывается по UTC: https://ru.wikipedia.org/wiki/%D0%92%D1%81%D0%B5%D0%BC%D0%B8%D1%80%D0%BD%D0%BE%D0%B5_%D0%BA%D0%BE%D0%BE%D1%80%D0%B4%D0%B8%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%B2%D1%80%D0%B5%D0%BC%D1%8F и передается в формате ISO 8601: https://en.wikipedia.org/wiki/ISO_8601. Пример: 2017-11-03T11:52:42.312Z Обязательный параметр для выплат в статусе succeeded.
    - `deal` object — Сделка, в рамках которой нужно провести выплату. Присутствует, если вы проводите Безопасную сделку: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics.
      - `id` string, required — Идентификатор сделки.
    - `self_employed` object — Данные самозанятого, который получит выплату. Устаревший параметр. Раньше возвращался при проведении выплат самозанятым. Сейчас функциональность недоступна. Параметр сохранен для поддержки обратной совместимости, в новых версиях API может быть удален.
      - `id` string, required — Идентификатор самозанятого в ЮKassa.
    - `receipt` IncomeReceipt — Данные чека, зарегистрированного в ФНС. Устаревший параметр. Раньше возвращался при проведении выплат самозанятым. Сейчас функциональность недоступна. Параметр сохранен для поддержки обратной совместимости, в новых версиях API может быть удален.
      - `service_name` string, required — Описание услуги, оказанной получателем выплаты. Не более 50 символов.
      - `npd_receipt_id` string — Идентификатор чека в сервисе. Пример: 208jd98zqe
      - `url` string — Ссылка на зарегистрированный чек. Пример: https://www.nalog.gov.ru/api/v1/receipt/<Идентификатор чека>/print
      - `amount` object — Сумма, указанная в чеке. Присутствует, если в запросе передавалась сумма для печати в чеке.
        - `value` string, required — Сумма в выбранной валюте. Всегда дробное значение. Разделитель дробной части — точка, разделитель тысяч отсутствует. Количество знаков после точки зависит от выбранной валюты. Пример: 1000.00.
        - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required — Трехбуквенный код валюты в формате ISO-4217: https://www.iso.org/iso-4217-currency-codes.html. Пример: RUB.
    - `cancellation_details` PayoutCancellationDetails — Комментарий к статусу canceled: кто отменил выплату и по какой причине.
      - `party` 'yoo_money' | 'payout_network', required — Участник процесса выплаты, который принял решение об отмене транзакции. Перечень инициаторов отмены выплаты: для обычных выплат: https://yookassa.ru/developers/payouts/after-the-payout/declined-payouts#cancellation-details-party, для выплат в рамках Безопасной сделки: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/integration/payouts#declined-payouts-cancellation-details-party.
      - `reason` 'insufficient_funds' | 'fraud_suspected' | 'one_time_limit_exceeded' | 'periodic_limit_exceeded' | 'rejected_by_payee' | 'general_decline' | 'issuer_unavailable' | 'recipient_not_found' | 'recipient_check_failed' | 'identification_required' | 'self_employed_annual_limit_exceeded', required — Причина отмены выплаты. Перечень и описание возможных значений: для обычных выплат: https://yookassa.ru/developers/payouts/after-the-payout/declined-payouts#cancellation-details-reason, для выплат в рамках Безопасной сделки: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/integration/payouts#declined-payouts-cancellation-details-reason.
    - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
    - `test` boolean, required — Признак тестовой операции.
  - `next_cursor` string — Указатель на следующий фрагмент списка. Обязательный параметр, если размер списка больше размера выдачи (limit) и конец выдачи не достигнут.

## Other responses

- `400` — Запрос не может быть обработан. Причиной может быть неправильный синтаксис запроса, ошибка в обязательных параметрах запроса, их отсутствие или неподдерживаемый метод.
- `401` — В заголовке Authorization указан неверный ключ.
- `403` — Секретный ключ указан верно, но не хватает прав для совершения операции.
- `404` — Сущность не найдена.
- `429` — Слишком много запросов одновременно отправляется в API. Повторите запрос позже.
- `500` — Внутренняя ошибка сервера ЮKassa.

---

[API](https://skmtc.dev/hexlet/apis/api-kassa.md) · [All operations](https://skmtc.dev/hexlet/apis/api-kassa/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/api-kassa/revisions/e79983ebb73d/schema)