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

Read-only расчёт комиссии вывода, которая будет применена к аутентифицированному мерчанту ДО отправки: переопределение для конкретного контрагента, если задано, иначе база тенанта — резолвится через ТОТ ЖЕ policy resolver, что использует платёжный путь, поэтому расчёт не может разойтись с фактически списанной комиссией. Необязательный amount_usdt_cents (центы USDT; обратите внимание — в запросе создания единицы целые USDT) также даёт чистую сумму.

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

Query Parameters

amount_usdt_cents?integer

Необязательная сумма вывода брутто в центах USDT (> 0 включает net_amount_usdt_cents).

Formatint64

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/wallet/withdraw-fee?amount_usdt_cents=100000" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "base_fee_usdt_cents": "150",  "override_applied": false,  "total_fee_usdt_cents": "150",  "net_amount_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"    }  ]}

Выдача (или ротация) TRC-20-адреса депозитов мерчанта POST POST

Генерирует (первый вызов) или ротирует (повторные вызовы) TRC-20-адрес депозитов мерчанта для входящего USDT-обеспечения. Область видимости резолвится из аутентифицированного контекста мерчанта (канонический путь, без `merchant_id` в пути). Атомарно занимает следующий индекс вывода BIP44, выводит адрес через tron-wallet-api и сохраняет адрес + индекс в запись мерчанта. Семантика ротации: новый адрес немедленно заменяет старый в записи мерчанта, при этом каждый ранее выданный адрес навсегда остаётся в вечном наборе блок-поллинга платформы — USDT, отправленные на заменённый адрес, по-прежнему обнаруживаются и зачисляются. Legacy-алиас с административной имперсонацией: `POST /api/v1/p2p/merchants/{merchant_id}/deposit-address`.

Входящие TRC-20-депозиты со статусами кастодии GET GET

Входящие TRC-20-депозиты мерчанта: зачисление леджера плюс жизненный цикл принимающего адреса от DepositSweepWorker (CREDITED / SWEEP_PENDING / SWEEP_FAILED / SWEEP_STUCK / SWEPT). Keyset-пагинация (AIP-158): page_size 1–100 (по умолчанию 20), page_token/next_page_token.