Выплаты клиентам (PayOut)

Выплата (PayOut) — это P2P-операция вывода средств, при которой мерчант создаёт заявку на перевод, а трейдер выполняет фактический перевод получателю со своего банковского счёта.

Процесс выплаты (PayOut Flow)

Эндпоинт создания PayOut

POST /api/v1/p2p/merchant/deals/payout

Параметры запроса (JSON Body)

Пример запроса

{
  "amount": 500000,
  "currency": "RUB",
  "wallet_id": "8f870a31-b88d-4cb0-a882-628d08cbda88",
  "target_requisite": "2202201234567890",
  "target_name": "Иван Иванович И.",
  "payment_method": "card_rub",
  "idempotency_key": "payout_order_99812"
}

Пример ответа (200 OK)

Ответ — объект MerchantDealInfo в поле deal верхнего уровня (обёртки data нет). Идентификатор сделки — deal_id (НЕ id). Для PAYOUT payment_url пуст (он есть только у PayIn); вместо него заполнено target_requisite. currency — эхо ISO-кода fiat-валюты выплаты из запроса.

Статус в ответе зависит от синхронного авто-матчинга каскада: если есть свободный трейдер — MATCHED (пример ниже); если свободного трейдера нет — UNASSIGNED (далее retry-воркер, см. Статусы PayOut сделки).

{
  "deal": {
    "deal_id": "e81d77a0-0d3a-4422-b91c-7cb052a2119c",
    "status": "MATCHED",
    "amount": "500000",
    "currency": "RUB",
    "created_at": "2026-07-12T17:21:00Z",
    "client_id": "",
    "deal_type": "PAYOUT",
    "updated_at": "2026-07-12T17:21:00Z",
    "payment_url": "",
    "target_requisite": "2202201234567890",
    "received_amount": "0",
    "amount_match_status": ""
  }
}

Статусы PayOut сделки

Канонический жизненный цикл — domain.PayOutStatus (7 значений). PayOut использует отдельный домен статусов от PayIn. Полная таблица с V1-кодами — в Справочнике статусов.

Особые статусы

• UNASSIGNED — на момент создания авто-матчинг каскада не нашёл свободного трейдера (все заняты / лимиты исчерпаны / нет реквизитов под эту валюту и сумму). Сделка возвращается с этим статусом в ответе POST /deals/payout, после чего retry-воркер автоматически повторяет мэтчинг: при успехе статус переходит в MATCHED → далее обычный жизненный цикл; если SLA на назначение истекает — выплата переходит в терминальный EXPIRED, холд возвращается мерчанту. Не терминальный статус. Ручное назначение (admin override) остаётся доступным для оператора.
• PayOut не использует PayIn-статусы (PAYMENT_NOTIFIED, PAYMENT_VERIFIED, APPEALED, SOFT_DISPUTED).

Выплаты TRY / IBAN (Havale)

Для Турции выплаты идут как банковский перевод по IBAN (RequisiteType BANK_TRANSFER): базовый реквизит — target_requisite (IBAN получателя), дополнительно заполняются target_bank и requisite_details.

Новые поля запроса

Пример запроса (TRY / Havale)

{
  "amount": 2500000,
  "currency": "TRY",
  "wallet_id": "8f870a31-b88d-4cb0-a882-628d08cbda88",
  "target_requisite": "TR33 0006 1005 1978 6457 8413 26",
  "target_name": "Ahmet Yilmaz",
  "target_bank": "ziraat",
  "requisite_details": {
    "iban": "TR33 0006 1005 1978 6457 8413 26",
    "document_number": "12345678901"
  },
  "payment_method": "express-havale",
  "idempotency_key": "payout_try_order_00042"
}

• amount: 2500000 = 25 000.00 TRY (минорные единицы — куруш, 2 знака).
• payment_method — слаг (или UUID) Havale-метода, заведённого для вашего тенанта (например, express-havale); значение резолвится против активных методов тенанта — неизвестная ссылка или метод другой валюты отклоняется с 400 (список методов и слагов вашего тенанта — GET /api/v1/p2p/merchant/payment-methods, см. Banks).
• requisite_details.document_number — пример дополнительного реквизита (TC kimlik / номер документа), нужен не всегда: передавайте, когда метод или банк получателя его требует.

Пример ответа (200 OK)

{
  "deal": {
    "deal_id": "c25f9b31-7e40-4a11-8f0a-6d92b7c4e155",
    "status": "MATCHED",
    "amount": "2500000",
    "currency": "TRY",
    "created_at": "2026-08-18T11:02:00Z",
    "client_id": "",
    "deal_type": "PAYOUT",
    "updated_at": "2026-08-18T11:02:00Z",
    "payment_url": "",
    "target_requisite": "TR33 0006 1005 1978 6457 8413 26",
    "received_amount": "0",
    "amount_match_status": ""
  }
}

target_requisite — эхо из запроса без маскировки (см. NOTE выше).

Лимиты на разовые выплаты

Лимиты сумм не захардкожены — они динамически определяются конфигурацией тенанта:

События вебхуков