S
docs.syncra.money
API ReferenceMerchant APIApi referenceDeals

Retrieve a deal by ID

Returns the details of a single deal scoped to the merchant.

GET/api/v1/p2p/merchant/deals/{deal_id}

Returns the details of a single deal scoped to the merchant.

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

Path Parameters

deal_id*string

Deal UUID.

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/deals/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "deal": {    "deal_id": "7ac148fe-1234-5678-9abc-def012345678",    "status": "PAYMENT_VERIFIED",    "amount": "150000",    "currency": "RUB",    "created_at": "2026-08-10T12:00:00Z",    "client_id": "player_42",    "deal_type": "PAYIN",    "updated_at": "2026-08-10T12:06:42Z",    "payment_url": "https://checkout.syncra.money/pay/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"  }}
{  "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"    }  ]}