S
docs.syncra.money
Финансы
ENRU
POST/api/v1/p2p/merchant/wallet/withdrawСтейдж

Инициирует вывод USDT на переданный TRC-20-адрес. Синхронный status — COMPLETED (авто-одобрение: on-chain-транзакция отправлена в broadcast) или PENDING_MANUAL (очередь одобрения админом — политика MANUAL_ONLY или сумма выше действующего авто-лимита). Недостаточный баланс — failed precondition → HTTP 400 (не 402). Идемпотентность гарантируется на стороне сервера (детерминированный ключ из merchant + address

  • amount + текущая комиссия).

Authorization

MerchantToken MerchantSignature MerchantTimestamp
X-Merchant-Token<token>

Публичный токен мерчанта (64 hex-символа), выдаётся при онбординге.

In: header

X-Signature<token>

Подпись HMAC-SHA256 (единая схема для всех эндпоинтов). Формат: t=<unix_seconds>,v1=<hex_hmac_sha256> где hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>"). Окно replay: 5 минут (допускается дрейф 60 секунд в будущее).

In: header

X-Timestamp<token>

Unix-время отправки запроса в секундах. Окно подписи: 5 минут назад / 60 секунд вперёд.

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 "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>" \  -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"    }  ]}

Получение балансов мерчанта GET GET

Возвращает реальные кошельки мерчанта из money-сервиса — по одной строке на фактический кошелёк с собственной валютой и `wallet_id` (без синтетических строк). `frozen` отражает активные холды.

Получение текущего TRC-20-адреса депозитов мерчанта GET GET

Только чтение: возвращает текущий активный TRC-20-адрес депозитов мерчанта, используемый для входящего USDT-обеспечения (пополнение операционного баланса мерчанта — выплаты, выводы и комиссии; клиенты в PayIn-сделках платят по реквизитам трейдеров, а НЕ на этот адрес). `tenant_id` / `merchant_id` в запросе носят информационный характер — при HMAC-аутентификации область видимости всегда резолвится из подписанного токена. Возвращает `404 Not Found` (problem+json), если адрес ещё не выдан.