POST /v1/wallet/blocked-address-refund

Вернуть средства, полученные на (обычно заблокированном) статическом кошельке, на один указанный адрес. Возвращается чистая сумма — та, что фактически была зачислена на баланс мерчанта: уже за вычетом комиссии платформы, удержанной при зачислении депозитов (ставка для статических кошельков, по умолчанию ~1.5% — см. Статические кошельки), и за вычетом отменённых reorg‑депозитов — депозитов, откатившихся при переписывании недавних блоков сети. По сути это списание с баланса — выплата; однократно и идемпотентно на уровне кошелька.

URL: https://api.oblodai.com/v1/wallet/blocked-address-refund · Аутентификация: обязательна.

Примеры используют хелпер call() и переменные $SECRET/$PUBLIC_ID — их определение см. в Как подписать запрос. Проще не писать подпись руками, а взять SDK.

---

​

Параметры запроса

uuid · string · обязательно

Идентификатор статического кошелька (из ответа /v1/wallet).

address · string · обязательно

Адрес назначения возврата.

---

​

Пример запроса

cURL

BODY='{"uuid":"0e5b6b9a-…","address":"TYr2...9kQp"}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/wallet/blocked-address-refund' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/wallet/blocked-address-refund \
  -X POST -H 'Content-Type: application/json' \
  -H "X-Public-Id: $PUBLIC_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" \
  -d "$BODY"

call("/v1/wallet/blocked-address-refund", {"uuid": "0e5b6b9a-…", "address": "TYr2...9kQp"})

await call("/v1/wallet/blocked-address-refund", { uuid: "0e5b6b9a-…", address: "TYr2...9kQp" });

---

​

Пример ответа

{
  "state": 0,
  "result": {
    "uuid": "b71c2d3e-…",
    "wallet_uuid": "0e5b6b9a-…",
    "amount": "149.50",
    "commission": "0.50",
    "currency": "USDT",
    "address": "TYr2...9kQp",
    "status": "check",
    "is_final": false
  }
}

uuid · string

Идентификатор операции возврата.

wallet_uuid · string

Кошелёк, с которого возвращаются средства.

amount · string

Возвращаемая чистая сумма.

commission · string

Удержанный сетевой газ.

currency · string

Валюта возврата.

address · string

Адрес назначения.

status · string

Статус операции (как у выплаты).

is_final · bool

Достигнут ли терминальный статус (конечное состояние, объект больше не изменится).

---

​

Коды ошибок

Код	Значение
400 request.bad_json	Тело не парсится.
400 refund.no_address	Не передан адрес назначения.
400 wallet.bad_uuid	Некорректный uuid.
400 refund.nothing_to_refund	На кошельке нет средств к возврату.
400 refund.destination_internal	Адрес назначения принадлежит шлюзу (self‑dealing — выплата на собственный адрес шлюза запрещена).
400 refund.dust	Сумма слишком мала (dust — не покрывает даже сетевую комиссию).
404 wallet.static_not_found	Кошелёк не найден.

Адрес назначения дополнительно проходит проверку формата под сеть и комплаенс‑скрининг.

---

​

Нюансы

• Возвращается только чистая сумма — reorg‑отменённые депозиты исключаются.
• При самом возврате удерживается только сетевой газ (commission), который вычитается из amount (получатель получает amount − commission); комиссия платформы уже была удержана при зачислении и в базу возврата не входит.
• Идемпотентно по кошельку (ключ refund-wallet:<uuid>).

---

​

Связанные страницы

POST /v1/wallet/block

Объект кошелька