/api/v1/p2p/merchant/deals/exportСтейджОтдаёт сделки мерчанта — 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 и устарело — стройте новые
интеграции на этом каноническом пути.
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
Query Parameters
Фильтр по направлению; пусто/отсутствует = оба (UNION).
Value in
- "PAYIN"
- "PAYOUT"
Повторяемые имена статусов БД (statuses=COMPLETED&statuses=EXPIRED).
Нижняя граница created_at (RFC3339, включительно).
date-timeВерхняя граница created_at (RFC3339, включительно).
date-timeResponse Body
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/p2p/merchant/deals/export" \ -H "X-Merchant-Token: <MERCHANT_TOKEN>" \ -H "X-Timestamp: <UNIX_TIMESTAMP>" \ -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"{ "csv": "string", "file_name": "string", "row_count": 0, "truncated": true}{ "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" } ]}Создание PayOut-сделки (выплата) POST POST
Инициирует выплату на переданные целевые реквизиты. Проверяет баланс мерчанта и размещает USDT-холд (курс SELL) перед созданием сделки. Далее следует синхронный каскадный авто-матчинг: при наличии свободного трейдера сделка возвращается в `MATCHED`; иначе — в `UNASSIGNED`, и worker повторного матчинга продолжает подбор, пока SLA назначения не истечёт сделку (`EXPIRED`, холд освобождается). Возвращает сделку с заполненным `target_requisite` получателя и `currency` как эхом из запроса (ISO-код фиатной валюты выплаты).
Ежедневный оборот сделок (график кабинета) GET GET
Одна агрегатная строка на (UTC-день × deal_type × валюта) в ограниченном окне дат, суммируется по той же поверхности UNION ALL, что и листинг (orders `amount` для PAYIN, payouts `amount_fiat` для PAYOUT). `date_from`/`date_to` ОБЯЗАТЕЛЬНЫ, RFC3339; окно ограничено 92 днями (свыше — InvalidArgument). Несостоявшиеся сделки исключаются (orders EXPIRED/SPAM_REJECTED, payouts FAILED/EXPIRED). Строки упорядочены по (date ASC, deal_type ASC, currency ASC); дни без сделок отсутствуют.