/api/v1/p2p/merchant/wallet/deposit-addressСтейджТолько чтение: возвращает текущий активный TRC-20-адрес депозитов
мерчанта, используемый для входящего USDT-обеспечения (пополнение
операционного баланса мерчанта — выплаты, выводы и комиссии; клиенты в
PayIn-сделках платят по реквизитам трейдеров, а НЕ на этот адрес).
tenant_id / merchant_id в запросе носят информационный характер — при HMAC-аутентификации
область видимости всегда резолвится из подписанного токена.
Возвращает 404 Not Found (problem+json), если адрес ещё
не выдан.
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
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "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>"{ "trc20_address": "TYHCiW3XN5sP9cWJ5T4Dfs9Y18h46t9w1a"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "instance": "../dictionary", "errors": [ { "field": "amount", "message": "must be greater than 0", "code": "POSITIVE_REQUIRED" } ]}{ "type": "about:blank", "title": "Not Found", "status": 404, "detail": "deposit address not provisioned yet — POST /wallet/deposit-address to generate one", "instance": "/api/v1/p2p/merchant/wallet/deposit-address"}Вывод USDT на TRC-20-адрес POST POST
Инициирует вывод USDT на переданный TRC-20-адрес. Синхронный `status` — COMPLETED (авто-одобрение: on-chain-транзакция отправлена в broadcast) или PENDING_MANUAL (очередь одобрения админом — политика MANUAL_ONLY или сумма выше действующего авто-лимита). Недостаточный баланс — failed precondition → HTTP 400 (не 402). Идемпотентность гарантируется на стороне сервера (детерминированный ключ из merchant + address + amount + текущая комиссия).
Выдача (или ротация) TRC-20-адреса депозитов мерчанта POST POST
Генерирует (первый вызов) или ротирует (повторные вызовы) TRC-20-адрес депозитов мерчанта для входящего USDT-обеспечения. Область видимости резолвится из аутентифицированного контекста мерчанта (канонический путь, без `merchant_id` в пути). Атомарно занимает следующий индекс вывода BIP44, выводит адрес через tron-wallet-api и сохраняет адрес + индекс в запись мерчанта. Семантика ротации: новый адрес немедленно заменяет старый в записи мерчанта, при этом каждый ранее выданный адрес навсегда остаётся в вечном наборе блок-поллинга платформы — USDT, отправленные на заменённый адрес, по-прежнему обнаруживаются и зачисляются. Legacy-алиас с административной имперсонацией: `POST /api/v1/p2p/merchants/{merchant_id}/deposit-address`.