---
title: "POST /payouts"
method: POST
path: "/payouts"
tags: ["Выплаты"]
---

# POST /payouts

`POST /payouts`

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

## Headers

- `Idempotence-Key` string, required

## Request body

- PayoutRequest
  - `amount` MonetaryAmount, required
    - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
    - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
  - `payout_destination_data` union — Данные для проведения выплаты.
    - PayoutToYooMoneyDestinationData
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required
    - PayoutToBankCardDestinationData
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required
    - PayoutToSbpDestinationData
      - `type` 'yoo_money' | 'bank_card' | 'sbp', required
  - `payout_token` string — Токен для проведения выплаты.
  - `payment_method_id` string
  - `description` string
  - `deal` PayoutDealInfo
    - `id` string, required
  - `personal_data` PayoutsPersonalData[] — Персональные данные получателя выплаты.
    - `id` string, required
  - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.

## Response `200`

The request has succeeded.

- Payout
  - `id` string, required
  - `amount` MonetaryAmount, required
    - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
    - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
  - `status` 'pending' | 'succeeded' | 'canceled', required
  - `payout_destination` union, required — Данные о назначении выплаты.
    - PayoutToCardDestination
      - `type` 'bank_card' | 'yoo_money' | 'sbp', required
    - PayoutToYooMoneyDestination
      - `type` 'bank_card' | 'yoo_money' | 'sbp', required
    - PayoutToSbpDestination
      - `type` 'bank_card' | 'yoo_money' | 'sbp', required
  - `description` string
  - `created_at` string, date-time, required — Время создания выплаты.
  - `succeeded_at` string, date-time — Время проведения выплаты.
  - `deal` PayoutDealInfo
    - `id` string, required
  - `self_employed` PayoutSelfEmployedInfo
    - `id` string, required
  - `receipt` IncomeReceipt
    - `service_name` string, required
    - `npd_receipt_id` string
    - `url` string
    - `amount` MonetaryAmount
      - `value` string, required — Сумма в выбранной валюте. Выражается в виде строки и пишется через точку, например 10.00.
      - `currency` 'RUB' | 'EUR' | 'USD' | 'KZT' | 'BYN' | 'UAH' | 'UZS' | 'TRY' | 'INR' | 'MDL' | 'AZN' | 'AMD', required
  - `cancellation_details` PayoutCancellationDetails
    - `party` string, required
    - `reason` string, required
  - `metadata` Metadata — Любые дополнительные данные, которые нужны вам для работы (например, номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32 символов, значение ключа не больше 512 символов, тип данных — строка в формате UTF-8.
  - `test` boolean, required — Признак тестовой операции.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `429` — Client error
- `500` — Server error

## Changes

- **2026-02-14** `fe24d3dfadad` — 34 breaking, 7 warning, 43 info
  - added `#/components/schemas/CurrencyCode` to the `amount/allOf[#/components/schemas/MonetaryAmount]/currency` request property `allOf` list
  - added `#/components/schemas/PayoutDealInfo` to the `deal` request property `allOf` list
  - the request property `metadata/additionalProperties/` became not nullable
  - removed the enum value `AMD` of the request property `amount/allOf[#/components/schemas/MonetaryAmount]/currency`
  - …80 more

[Change history](https://skmtc.dev/hexlet/apis/api-kassa/changes/payouts/post.md)

---

[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/f35dc69c1c37/schema)