/api/v1/p2p/merchant/wallet/deposit-addressСтейджГенерирует (первый вызов) или ротирует (повторные вызовы) TRC-20-адрес
депозитов мерчанта для входящего USDT-обеспечения. Область видимости
резолвится из аутентифицированного контекста мерчанта (канонический путь,
без merchant_id в пути). Атомарно занимает следующий индекс вывода
BIP44, выводит адрес через tron-wallet-api и сохраняет адрес + индекс
в запись мерчанта. Семантика ротации: новый адрес немедленно заменяет
старый в записи мерчанта, при этом каждый ранее выданный адрес навсегда
остаётся в вечном наборе блок-поллинга платформы — USDT, отправленные
на заменённый адрес, по-прежнему обнаруживаются и зачисляются.
Legacy-алиас с административной имперсонацией:
POST /api/v1/p2p/merchants/{merchant_id}/deposit-address.
Authorization
MerchantToken MerchantSignature MerchantTimestamp Публичный токен мерчанта (64 hex-символа), выдаётся при онбординге.
In: header
Подпись HMAC-SHA256 (единая схема для всех эндпоинтов).
Формат: t=<unix_seconds>,v1=<hex_hmac_sha256>
где hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>").
Окно replay: 5 минут (допускается дрейф 60 секунд в будущее).
In: header
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
curl -X POST "https://example.com/api/v1/p2p/merchant/wallet/deposit-address" \ -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 '{}'{ "trc20_address": "TYHCiW3XN5sP9cWJ5T4Dfs9Y18h46t9w1a", "wallet_derivation_index": 17}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}Получение текущего TRC-20-адреса депозитов мерчанта GET GET
Только чтение: возвращает текущий активный TRC-20-адрес депозитов мерчанта, используемый для входящего USDT-обеспечения (пополнение операционного баланса мерчанта — выплаты, выводы и комиссии; клиенты в PayIn-сделках платят по реквизитам трейдеров, а НЕ на этот адрес). `tenant_id` / `merchant_id` в запросе носят информационный характер — при HMAC-аутентификации область видимости всегда резолвится из подписанного токена. Возвращает `404 Not Found` (problem+json), если адрес ещё не выдан.
Расчёт комиссии вывода до отправки запроса GET GET
Read-only расчёт комиссии вывода, которая будет применена к аутентифицированному мерчанту ДО отправки: переопределение для конкретного контрагента, если задано, иначе база тенанта — резолвится через ТОТ ЖЕ policy resolver, что использует платёжный путь, поэтому расчёт не может разойтись с фактически списанной комиссией. Необязательный `amount_usdt_cents` (центы USDT; обратите внимание — в запросе создания единицы целые USDT) также даёт чистую сумму.