S
docs.syncra.money
Deals
ENRU
GET/api/v1/p2p/merchant/dealsСтейдж

Returns the merchant's deals filtered by type, status, and date. The listing is a UNION of PayIn (p2p_orders) and PayOut (p2p_payouts) records in a single chronological list. Keyset-based pagination via page_token. The scope is always derived from the signed merchant token (claims take priority); the merchant_id request field is informational and silently ignored.

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

deal_type?string

Filter by deal direction.

Value in

  • "PAYIN"
  • "PAYOUT"
statuses?array<|>

Filter by one or more deal statuses (OrderStatus for PayIn, PayOutStatus for PayOut — the UNION listing accepts both sets).

created_after?string

Only deals created at or after this timestamp (RFC 3339, inclusive).

Formatdate-time
created_before?string

Only deals created at or before this timestamp (RFC 3339, inclusive).

Formatdate-time
page_size?integer

The maximum number of results returned (deal listing semantics: 50 by default, 250 at most). Compact listings (callbacks, passes, appeals, deposits, withdrawals) use 20 / 100 — see the per-endpoint parameter overrides.

Formatint32
Range1 <= value <= 250
Default50
page_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/deals" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "data": [    {      "deal_id": "7ac148fe-1234-5678-9abc-def012345678",      "status": "COMPLETED",      "amount": "150000",      "currency": "RUB",      "created_at": "2026-08-10T12:00:00Z",      "client_id": "player_42",      "deal_type": "PAYIN",      "updated_at": "2026-08-10T12:10:00Z",      "payment_url": "https://checkout.syncra.money/pay/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"    },    {      "deal_id": "8bd2590f-2345-6789-abcd-ef1234567890",      "status": "MATCHED",      "amount": "500000",      "currency": "RUB",      "created_at": "2026-08-10T12:05:00Z",      "client_id": "player_43",      "deal_type": "PAYOUT",      "updated_at": "2026-08-10T12:05:00Z",      "target_requisite": "2202201234567890"    }  ],  "next_page_token": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wOC0xMFQxMjowNTowMFoifQ=="}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}

Cancel a PayIn deal POST POST

Explicitly cancels a deposit (PayIn) deal before the payment is verified. Allowed only from `INITIALIZED`, `ESCROW_LOCKED`, or `PAYMENT_NOTIFIED`; escrow holds are released automatically, the fee breakdown is zeroed, and matches are marked `FAILED`. Cancelling an already-`CANCELLED` deal again returns it unchanged (idempotent). Clients cancel via the public checkout endpoint `POST /api/v1/p2p/checkout/{hash}/cancel`.

Retrieve merchant balances GET GET

Returns the merchant's real wallets from the money service — one row per actual wallet with its own currency and `wallet_id` (no synthetic rows). `frozen` reflects active holds.