Получение детальной информации, фильтрация истории и агрегированная статистика по P2P-сделкам мерчанта

Управление и мониторинг сделок (Deals)

Для контроля прохождения платежей и выплат Syncra Merchant API V2 предоставляет набор методов для запроса детальной информации по конкретной сделке, получения списков (истории) сделок с гибкой фильтрацией, а также расчета статистических агрегатов.

Детали конкретной сделки

Для запроса информации по известному идентификатору транзакции используется GET-эндпоинт:

GET /api/v1/p2p/merchant/deals/{deal_id}

Параметры пути (Path Parameters)

Имя	Тип	Обяз.	Описание
`deal_id`	string(UUID)	Да	Уникальный системный идентификатор сделки в формате UUID (например, `7ac148fe-19a3-45bb-b992-019fac55b721`).

Пример успешного ответа (`200 OK`)

{
  "data": {
    "deal_id": "7ac148fe-19a3-45bb-b992-019fac55b721",
    "idempotency_key": "order_uuid_abc123456",
    "client_id": "player_user_9921",
    "type": "PAYIN",
    "status": "PAID",
    "amount": 250050,
    "currency": "RUB",
    "created_at": "2026-07-12T17:20:00Z",
    "updated_at": "2026-07-12T17:24:12Z"
  }
}

Список сделок (История)

Вы можете запрашивать постраничную историю платежей и выплат с возможностью фильтрации по датам, статусам и типам операций.

GET /api/v1/p2p/merchant/deals

Параметры фильтрации (Query Parameters)

Поле	Тип	Обяз.	Описание
`deal_type`	string	Нет	Тип операции: `"PAYIN"` или `"PAYOUT"`.
`statuses`	array	Нет	Массив интересующих статусов для фильтрации, например: `statuses=PAID&statuses=OVERPAID`.
`created_after`	string(RFC3339)	Нет	Нижняя граница времени создания сделки (включительно).
`created_before`	string(RFC3339)	Нет	Верхняя граница времени создания сделки (исключительно).
`page_size`	int32	Нет	Количество элементов на странице (по умолчанию `20`, максимум `250`).
`page_token`	string	Нет	Токен для запроса следующей страницы результатов (получается из предыдущего ответа).

Пример ответа

{
  "data": {
    "deals": [
      {
        "deal_id": "7ac148fe-19a3-45bb-b992-019fac55b721",
        "deal_type": "PAYIN",
        "status": "PAID",
        "amount": 250050,
        "currency": "RUB",
        "created_at": "2026-07-12T17:20:00Z",
        "updated_at": "2026-07-12T17:24:12Z"
      },
      {
        "deal_id": "e81d77a0-0d3a-4422-b91c-7cb052a2119c",
        "deal_type": "PAYOUT",
        "status": "PENDING",
        "amount": 500000,
        "currency": "RUB",
        "created_at": "2026-07-12T17:21:00Z",
        "updated_at": "2026-07-12T17:21:05Z"
      }
    ],
    "next_page_token": "2026-07-12T17:21:00Z|e81d77a0-0d3a-4422-b91c-7cb052a2119c",
    "total_count": 2
  }
}

Статистика сделок

Для вывода агрегированных показателей за период времени используйте эндпоинт статистики:

POST /api/v1/p2p/merchant/deals/statistics

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

Поле	Тип	Обяз.	Описание
`type`	string	Да	`"PAYIN"` или `"PAYOUT"`.
`start_date`	string(RFC3339)	Да	Начало анализируемого периода.
`end_date`	string(RFC3339)	Да	Конец анализируемого периода.

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

{
  "data": {
    "type": "PAYIN",
    "total_count": 1450,
    "successful_count": 1280,
    "failed_count": 170,
    "conversion_rate": 88.27,
    "total_amount": 348050000,
    "currency": "RUB",
    "total_fees": 10441500
  }
}

История и детали сделок (Deals)