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

One aggregate row per (UTC day × deal_type × currency) within a bounded date window, summed over the same UNION ALL surface as the listing (orders amount for PAYIN, payouts amount_fiat for PAYOUT). date_from/date_to are REQUIRED, RFC3339; the window is capped at 92 days (beyond that — InvalidArgument). Unsuccessful deals are excluded (orders EXPIRED/SPAM_REJECTED, payouts FAILED/EXPIRED). Rows are ordered by (date ASC, deal_type ASC, currency ASC); days without deals are absent.

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

date_from*string

Start of the window (RFC3339, inclusive).

Formatdate-time
date_to*string

End of the window (RFC3339, inclusive; not earlier than date_from).

Formatdate-time
deal_type?string

Optional direction filter; empty = both.

Value in

  • "PAYIN"
  • "PAYOUT"

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/deals/turnover?date_from=2019-08-24T14%3A15%3A22Z&date_to=2019-08-24T14%3A15%3A22Z" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "data": [    {      "date": "2026-08-23",      "deal_type": "PAYIN",      "amount_minor": "100000",      "currency": "RUB"    },    {      "date": "2026-08-23",      "deal_type": "PAYOUT",      "amount_minor": "96971",      "currency": "RUB"    }  ],  "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"    }  ]}

Export deals to CSV (canonical path) GET GET

Returns the merchant's deals — PayIn (orders) AND PayOut (payouts), UNION over the ListMerchantDeals contract — as an RFC 4180 CSV document. The filters match the listing one-to-one; no pagination (a 10,000 data row limit, `truncated: true` when reached). `Accept: text/csv` returns the raw document with `Content-Disposition: attachment; filename="deals-YYYYMMDD.csv"`; any other Accept gets the JSON wrapper (`csv`/`file_name`/`row_count`/`truncated`). The legacy mirror `GET /api/v1/p2p/deals/export` (without the /merchant prefix) keeps working for wire-compat and is deprecated — build new integrations on this canonical path.

Retrieve a deal by ID GET GET

Returns the details of a single deal within the merchant scope.