/api/v1/p2p/merchant/deals/{deal_id}/cancelСтейджЯвно отменяет депозитную (PayIn) сделку до верификации платежа.
Разрешено только из INITIALIZED, ESCROW_LOCKED или
PAYMENT_NOTIFIED; эскроу-холды снимаются автоматически, разбивка
комиссии обнуляется, а матчи помечаются FAILED. Повторная отмена уже
CANCELLED-сделки возвращает её без изменений (идемпотентно).
Клиенты отменяют через публичный эндпоинт checkout
POST /api/v1/p2p/checkout/{hash}/cancel.
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
Path Parameters
UUID сделки.
uuidRequest 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/497f6eca-6276-4993-bfeb-53cbbbba6f08/cancel" \ -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 '{}'{ "deal": { "deal_id": "7ac148fe-1234-5678-9abc-def012345678", "status": "CANCELLED", "amount": "150000", "currency": "RUB", "created_at": "2026-08-10T12:00:00Z", "client_id": "player_42", "deal_type": "PAYIN", "updated_at": "2026-08-10T12:04:10Z" }}{ "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" } ]}Получение сделки по ID GET GET
Возвращает детали одной сделки в рамках мерчанта.
Листинг сделок мерчанта GET GET
Возвращает сделки мерчанта с фильтрацией по типу, статусу и дате. Листинг — UNION записей PayIn (`p2p_orders`) и PayOut (`p2p_payouts`) в одном хронологическом списке. Пагинация keyset-based через `page_token`. Область видимости всегда выводится из подписанного токена мерчанта (claims приоритетны); поле запроса `merchant_id` носит информационный характер и молча игнорируется.