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

История выводов мерчанта: очередь ручного одобрения, объединённая с исполненными списаниями леджера, дедуплицированная по on-chain хэшу транзакции. Статусы: PENDING (ожидает одобрения), APPROVED (одобрен, ещё не в broadcast), COMPLETED (broadcast, есть tx-хэш), CANCELLED (отклонён оператором). Та же keyset-пагинация, что у депозитов.

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

page_size?integer

Максимальное число возвращаемых результатов (по умолчанию 20, максимум 100).

Formatint32
Range1 <= value <= 100
Default20
page_token?string

Непрозрачный токен пагинации, возвращённый предыдущей страницей.

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1/p2p/merchant/wallet/withdrawals" \  -H "X-Merchant-Token: <MERCHANT_TOKEN>" \  -H "X-Timestamp: <UNIX_TIMESTAMP>" \  -H "X-Signature: t=<UNIX_TIMESTAMP>,v1=<HEX_HMAC_SHA256>"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "amount_usdt_cents": 0,      "fee_usdt_cents": 0,      "net_usdt_cents": 0,      "tx_hash": "string",      "status": "PENDING",      "tron_address": "string"    }  ],  "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"    }  ]}

Входящие 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.

Повторная постановка доставки вебхука в очередь (ручной retry) POST POST

Ставит в очередь немедленную повторную доставку ОДНОЙ из собственных доставок вебхуков вызывающего. Подходят только записи с терминальным провалом (статус ERROR или RETRY); PENDING/SUCCESS отклоняются с 400 FAILED_PRECONDITION. Rate limit: не более одного ручного retry на запись за 60 секунд (иначе 429 RESOURCE_EXHAUSTED). Чужой callback_id — 403, неизвестный — 404. Перезаписанная строка возвращается со статусом PENDING, очищенными полями ответа и СОХРАНЁННЫМ retry_count (в отличие от админского retry, который сбрасывает счётчик попыток). Двойная аутентификация: HMAC-пара или JWT кабинета. Тело — пустой JSON-объект.