S
docs.syncra.money
API ReferenceMerchant APIApi referenceFinance

Retrieve merchant balances

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.

GET/api/v1/p2p/merchant/balance

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.

Authorization

MerchantToken MerchantSignature
X-Merchant-Token<token>

64-character hex public merchant token assigned during onboarding.

In: header

X-Signature<token>

Stripe-style HMAC-SHA256 signature. Format: t=<unix_seconds>,v1=<hex_hmac_sha256> where hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>"). Replay window: 5 minutes (60s future drift tolerated).

In: header

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/balance"
{  "wallets": [    {      "wallet_id": "f0e1d2c3-b4a5-6789-abcd-ef1234567890",      "currency": "RUB",      "available": "12500000",      "frozen": "500000",      "total": "13000000"    },    {      "wallet_id": "9b2fcbd6-b6f4-4f17-a94d-b7309f84bde5",      "currency": "USDT",      "available": "2500000",      "frozen": "0",      "total": "2500000"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}