Disputes
GET
/api/v1/p2p/merchant/appealsСтейджReturns all the merchant's disputes with optional status filtering.
Authorization
MerchantToken MerchantSignature MerchantTimestamp X-Merchant-Token<token>
The merchant's public token (64 hex characters), issued at onboarding.
In: header
X-Signature<token>
HMAC-SHA256 signature (a single scheme for all endpoints).
Format: t=<unix_seconds>,v1=<hex_hmac_sha256>
where hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>").
Replay window: 5 minutes (a 60-second drift into the future is allowed).
In: header
X-Timestamp<token>
Unix time of the request in seconds. Signature window: 5 minutes back / 60 seconds forward.
In: header
Query Parameters
status?string
Filter by appeal status.
Value in
- "OPEN"
- "IN_PROGRESS"
- "REOPENED"
- "SATISFIED"
- "REJECTED"
page_size?integer
The maximum number of results returned (20 by default, 100 at most).
Format
int32Range
1 <= value <= 100Default
20page_token?string
An opaque pagination token returned by the previous page.
Response Body
application/json
application/problem+json
curl -X GET "https://example.com/api/v1/p2p/merchant/appeals" \ -H "X-Merchant-Token: <MERCHANT_TOKEN>" \ -H "X-Timestamp: <UNIX_TIMESTAMP>" \ -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"{ "data": [ { "appeal_id": "c1d2e3f4-5678-90ab-cdef-1234567890ab", "deal_id": "7ac148fe-1234-5678-9abc-def012345678", "status": "OPEN", "reason": "Funds not credited within 30 minutes", "resolution_note": "", "created_at": "2026-08-10T12:45:00Z", "resolved_at": "", "updated_at": "2026-08-10T12:45:00Z" }, { "appeal_id": "d2e3f4a5-6789-0abc-def1-234567890abc", "deal_id": "8bd2590f-2345-6789-abcd-ef1234567890", "status": "IN_PROGRESS", "reason": "Wrong recipient name", "resolution_note": "", "created_at": "2026-08-09T15:20:00Z", "resolved_at": "", "updated_at": "2026-08-10T09: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" } ]}