/api/v1/p2p/merchant/deals/payoutСтейджИнициирует выплату на переданные целевые реквизиты. Проверяет баланс
мерчанта и размещает USDT-холд (курс SELL) перед созданием сделки. Далее
следует синхронный каскадный авто-матчинг: при наличии свободного трейдера
сделка возвращается в MATCHED; иначе — в UNASSIGNED, и worker повторного
матчинга продолжает подбор, пока SLA назначения не истечёт сделку
(EXPIRED, холд освобождается).
Возвращает сделку с заполненным target_requisite получателя и
currency как эхом из запроса (ISO-код фиатной валюты выплаты).
Authorization
MerchantToken MerchantSignature MerchantTimestamp Публичный токен мерчанта (64 hex-символа), выдаётся при онбординге.
In: header
Подпись HMAC-SHA256 (единая схема для всех эндпоинтов).
Формат: t=<unix_seconds>,v1=<hex_hmac_sha256>
где hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>").
Окно replay: 5 минут (допускается дрейф 60 секунд в будущее).
In: header
Unix-время отправки запроса в секундах. Окно подписи: 5 минут назад / 60 секунд вперёд.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/v1/p2p/merchant/deals/payout" \ -H "X-Merchant-Token: <MERCHANT_TOKEN>" \ -H "X-Timestamp: <UNIX_TIMESTAMP>" \ -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>" \ -H "Content-Type: application/json" \ -d '{ "amount": 500000, "currency": "RUB", "wallet_id": "d9a8fbfc-848f-43a2-9168-911ed3a04a48", "idempotency_key": "payout_order_99812", "target_requisite": "2202201234567890", "payment_method": "card_rub" }'{ "deal": { "deal_id": "8bd2590f-2345-6789-abcd-ef1234567890", "status": "MATCHED", "amount": "500000", "currency": "RUB", "created_at": "2026-08-10T12:05:00Z", "client_id": "player_42", "deal_type": "PAYOUT", "updated_at": "2026-08-10T12:05:00Z", "target_requisite": "2202201234567890" }}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}Создание PayIn-сделки (эквайринг) POST POST
Создаёт новую сделку входящего платежа с опциональным матчингом пропусков белого списка. Идемпотентно: дубликат `idempotency_key` возвращает закешированный результат. Возвращает публичный `payment_url`, на который мерчанту следует редиректить клиента.
Экспорт сделок в CSV (канонический путь) GET GET
Отдаёт сделки мерчанта — PayIn (orders) И PayOut (payouts), UNION по контракту ListMerchantDeals — как CSV-документ RFC 4180. Фильтры один в один совпадают с листингом; без пагинации (ограничение 10 000 строк данных, `truncated: true` при достижении). `Accept: text/csv` возвращает сырой документ с `Content-Disposition: attachment; filename="deals-YYYYMMDD.csv"`; любой другой Accept получает JSON-обёртку (`csv`/`file_name`/`row_count`/`truncated`). Legacy-зеркало `GET /api/v1/p2p/deals/export` (без префикса /merchant) продолжает работать ради wire-compat и устарело — стройте новые интеграции на этом каноническом пути.