Диспуты
GET
/api/v1/p2p/merchant/appeals/{appeal_id}/messagesСтейджAuthorization
MerchantToken MerchantSignature MerchantTimestamp X-Merchant-Token<token>
Публичный токен мерчанта (64 hex-символа), выдаётся при онбординге.
In: header
X-Signature<token>
Подпись HMAC-SHA256 (единая схема для всех эндпоинтов).
Формат: t=<unix_seconds>,v1=<hex_hmac_sha256>
где hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>").
Окно replay: 5 минут (допускается дрейф 60 секунд в будущее).
In: header
X-Timestamp<token>
Unix-время отправки запроса в секундах. Окно подписи: 5 минут назад / 60 секунд вперёд.
In: header
Path Parameters
appeal_id*string
UUID апелляции.
Format
uuidQuery Parameters
page_size?integer
Зарезервировано контрактом — текущий релиз возвращает всю историю сообщений (пагинация пока не применяется).
Format
int32page_token?string
Зарезервировано контрактом — см. page_size выше (next_page_token остаётся пустым).
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/p2p/merchant/appeals/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages" \ -H "X-Merchant-Token: <MERCHANT_TOKEN>" \ -H "X-Timestamp: <UNIX_TIMESTAMP>" \ -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"{ "data": [ { "message_id": "e3f4a5b6-7890-abcd-ef12-34567890abcd", "appeal_id": "c1d2e3f4-5678-90ab-cdef-1234567890ab", "sender_role": "MERCHANT", "body": "Please check the attached bank transfer screenshot.", "file_ids": [ "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ], "created_at": "2026-08-10T13:05:00Z" }, { "message_id": "f4a5b6c7-8901-bcde-f123-4567890abcde", "appeal_id": "c1d2e3f4-5678-90ab-cdef-1234567890ab", "sender_role": "ADMIN", "body": "Received. Reviewing the evidence, will respond within 1 hour.", "file_ids": [], "created_at": "2026-08-10T13:10:00Z" } ], "next_page_token": ""}{ "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" } ]}