S
docs.syncra.money
API ReferenceMerchant APIApi referenceFinance

Withdraw USDT to a TRC-20 address

Initiates a USDT withdrawal to the supplied TRC-20 address. The synchronous `status` is COMPLETED (auto-approved: on-chain tx broadcast) or PENDING_MANUAL (admin approval queue — MANUAL_ONLY policy or amount above the effective auto limit). Insufficient balance is a failed precondition → HTTP 400 (not 402). Idempotency is guaranteed server-side (deterministic key over merchant + address + amount + current fee).

POST/api/v1/p2p/merchant/wallet/withdraw

Initiates a USDT withdrawal to the supplied TRC-20 address. The synchronous status is COMPLETED (auto-approved: on-chain tx broadcast) or PENDING_MANUAL (admin approval queue — MANUAL_ONLY policy or amount above the effective auto limit). Insufficient balance is a failed precondition → HTTP 400 (not 402). Idempotency is guaranteed server-side (deterministic key over merchant + address

  • amount + current fee).

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/v1/p2p/merchant/wallet/withdraw" \  -H "Content-Type: application/json" \  -d '{    "amount_usdt": 1000,    "tron_address": "TRx7Vn2a3bK8HJdZmFc4eD5q1wP9nLs6t"  }'
{  "status": "COMPLETED",  "transaction_id": "0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",  "amount_usdt": "1000",  "tron_address": "TRx7Vn2a3bK8HJdZmFc4eD5q1wP9nLs6t",  "created_at": "2026-08-10T13:00:00Z",  "fee_usdt_cents": "150",  "net_usdt_cents": "99850"}
{  "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"    }  ]}

Retrieve merchant balances 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.

Get the current merchant TRC-20 deposit address GET

Read-only: returns the merchant's current active TRC-20 deposit address used for incoming USDT collateral (merchant operational balance top-up — payouts, withdrawals and commissions; players pay traders' requisites in PayIn deals, NOT this address). `tenant_id` / `merchant_id` in the request are advisory — with HMAC authentication the scope always resolves from the signed token. Returns `404 Not Found` (problem+json) when no address has been provisioned yet.