/api/v1/p2p/merchant/wallet/depositsСтейджВходящие TRC-20-депозиты мерчанта: зачисление леджера плюс жизненный цикл принимающего адреса от DepositSweepWorker (CREDITED / SWEEP_PENDING / SWEEP_FAILED / SWEEP_STUCK / SWEPT). Keyset-пагинация (AIP-158): page_size 1–100 (по умолчанию 20), page_token/next_page_token.
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
Query Parameters
Максимальное число возвращаемых результатов (по умолчанию 20, максимум 100).
int321 <= value <= 10020Непрозрачный токен пагинации, возвращённый предыдущей страницей.
Response Body
application/json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1/p2p/merchant/wallet/deposits" \ -H "X-Merchant-Token: <MERCHANT_TOKEN>" \ -H "X-Timestamp: <UNIX_TIMESTAMP>" \ -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"{ "data": [ { "block_timestamp": "2019-08-24T14:15:22Z", "amount_usdt_cents": 0, "tx_hash": "string", "trc20_address": "string", "status": "CREDITED" } ], "next_page_token": "string"}{ "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
Read-only расчёт комиссии вывода, которая будет применена к аутентифицированному мерчанту ДО отправки: переопределение для конкретного контрагента, если задано, иначе база тенанта — резолвится через ТОТ ЖЕ policy resolver, что использует платёжный путь, поэтому расчёт не может разойтись с фактически списанной комиссией. Необязательный `amount_usdt_cents` (центы USDT; обратите внимание — в запросе создания единицы целые USDT) также даёт чистую сумму.
История выводов (ручная очередь, объединённая с исполненными списаниями) GET GET
История выводов мерчанта: очередь ручного одобрения, объединённая с исполненными списаниями леджера, дедуплицированная по on-chain хэшу транзакции. Статусы: PENDING (ожидает одобрения), APPROVED (одобрен, ещё не в broadcast), COMPLETED (broadcast, есть tx-хэш), CANCELLED (отклонён оператором). Та же keyset-пагинация, что у депозитов.