---
title: "Создание выплаты"
method: POST
path: "/payouts"
tags: ["Выплаты"]
---

# Создание выплаты

`POST /payouts`

Используйте этот запрос, чтобы создать в ЮKassa объект выплаты: https://yookassa.ru/developers/api#payout_object. В запросе необходимо передать сумму выплаты, данные о способе получения выплаты (например, номер кошелька ЮMoney), описание выплаты и при необходимости дополнительные параметры, связанные с той функциональностью, которую вы хотите использовать. Передаваемые параметры и данные для аутентификации: 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.

## Headers

- `Idempotence-Key` string, required

## Request body

- PayoutRequest — Данные для создания выплаты.
  - `amount` object, required — Сумма выплаты. Есть ограничения на минимальный и максимальный размер выплаты и сумму выплат за месяц. Подробнее о лимитах обычных выплат: https://yookassa.ru/developers/payouts/getting-started/payout-types-and-limits и выплат в рамках Безопасной сделки: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/integration/payouts#specifics
    - `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.
  - `payout_destination_data` union
    - PayoutToYooMoneyDestinationData — Данные платежного средства, на которое нужно сделать выплату. Обязательный параметр, если не передан payout_token или payment_method_id. Выплаты через СБП доступны только при обычных выплатах и только при выплатах физическим лицам.
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required — Способ получения выплаты: yoo_money — выплаты на кошелек ЮMoney; bank_card — выплаты на банковскую карту; sbp — выплаты через СБП на счет в банке или платежном сервисе.
      - `account_number` string, required — Номер кошелька ЮMoney, например 41001614575714. Длина от 11 до 33 цифр. Статус кошелька: https://yoomoney.ru/page?id=536140: для обычных выплат: https://yookassa.ru/developers/payouts/overview — любой, для выплат в рамках Безопасной сделки: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics — именной или идентифицированный.
    - PayoutToBankCardDestinationData — Данные платежного средства, на которое нужно сделать выплату. Обязательный параметр, если не передан payout_token или payment_method_id. Выплаты через СБП доступны только при обычных выплатах и только при выплатах физическим лицам.
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required — Способ получения выплаты: yoo_money — выплаты на кошелек ЮMoney; bank_card — выплаты на банковскую карту; sbp — выплаты через СБП на счет в банке или платежном сервисе.
      - `card` CardDataForPayoutDestination, required — Данные банковской карты для выплаты.
        - `number` string, required — Номер банковской карты. Формат: только цифры, без пробелов. Пример: 5555555555554477
    - PayoutToSbpDestinationData — Данные платежного средства, на которое нужно сделать выплату. Обязательный параметр, если не передан payout_token или payment_method_id. Выплаты через СБП доступны только при обычных выплатах и только при выплатах физическим лицам.
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required — Способ получения выплаты: yoo_money — выплаты на кошелек ЮMoney; bank_card — выплаты на банковскую карту; sbp — выплаты через СБП на счет в банке или платежном сервисе.
      - `phone` string, required — Телефон, к которому привязан счет получателя выплаты в системе участника СБП. Указывается в формате ITU-T E.164: https://ru.wikipedia.org/wiki/E.164, например 79000000000.
      - `bank_id` string, required — Идентификатор выбранного участника СБП — банка или платежного сервиса, подключенного к сервису. Формат: 12 символов. Как получить идентификатор участника СБП: https://yookassa.ru/developers/payouts/making-payouts/sbp
  - `payout_token` string — Токенизированные данные для выплаты. Например, синоним банковской карты. Обязательный параметр, если не передан payout_destination_data или payment_method_id.
  - `payment_method_id` string — Идентификатор сохраненного способа оплаты, данные которого нужно использовать для проведения выплаты. Подробнее о выплатах с использованием идентификатора сохраненного способа оплаты: https://yookassa.ru/developers/payouts/scenario-extensions/multipurpose-token Обязательный параметр, если не передан payout_destination_data или payout_token.
  - `description` string — Описание транзакции (не более 128 символов). Например: «Выплата по договору 37».
  - `deal` PayoutDealInfo — Сделка, в рамках которой нужно провести выплату. Необходимо передавать, если вы проводите Безопасную сделку: https://yookassa.ru/developers/solutions-for-platforms/safe-deal/basics
    - `id` string, required — Идентификатор сделки.
  - `personal_data` PayoutsPersonalData[] — Персональные данные получателя выплаты. Только для обычных выплат. Необходимо передавать в этих сценариях: выплаты с проверкой получателя: https://yookassa.ru/developers/payouts/scenario-extensions/recipient-check (только для выплат через СБП); выплаты с передачей данных получателя для выписок из реестра: https://yookassa.ru/developers/payouts/scenario-extensions/recipient-data-send. В массиве можно одновременно передать несколько идентификаторов, но только для разных типов данных.
    - `id` string, required — Идентификатор персональных данных, сохраненных в ЮKassa.
  - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, ваш внутренний идентификатор заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.

## Response `200`

Запрос принят в обработку и успешно обработан.

- Payout — Объект выплаты (Payout) — актуальная информация о выплате.
  - `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 — Признак тестовой операции.

## Other responses

- `400` — Запрос не может быть обработан. Причиной может быть неправильный синтаксис запроса, ошибка в обязательных параметрах запроса, их отсутствие или неподдерживаемый метод.
- `401` — В заголовке Authorization указан неверный ключ.
- `403` — Секретный ключ указан верно, но не хватает прав для совершения операции.
- `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)