POST /v1/wallet/block

Заблокировать или разблокировать статический кошелёк по адресу. Заблокированный кошелёк перестаёт зачислять новые пополнения.

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

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

---

​

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

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

Адрес статического кошелька.

is_force_block · bool · по умолчанию: true

true — заблокировать (значение по умолчанию, если поле опущено); false — снять блокировку.

---

​

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

cURL

# Заблокировать
BODY='{"address":"TXk9...c3Fd"}'
TS=$(date +%s)
SIG=$(printf '%s\n%s\n%s\n%s' "$TS" 'POST' '/v1/wallet/block' "$BODY" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s https://api.oblodai.com/v1/wallet/block \
  -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/block", {"address": "TXk9...c3Fd"})                       # заблокировать
call("/v1/wallet/block", {"address": "TXk9...c3Fd", "is_force_block": False})  # разблокировать

await call("/v1/wallet/block", { address: "TXk9...c3Fd" });                        // заблокировать
await call("/v1/wallet/block", { address: "TXk9...c3Fd", is_force_block: false }); // разблокировать

---

​

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

{ "state": 0, "result": { "uuid": "0e5b6b9a-…", "address": "TXk9...c3Fd", "blocked": true } }

---

​

Коды ошибок

Код	Значение
400 request.bad_json	Тело не парсится.
400 wallet.no_address	Не передан address.
404 wallet.static_not_found	Кошелёк не найден.

---

​

Нюансы

• is_force_block по умолчанию true. Чтобы снять блокировку, явно передайте false.
• Операция скоуплена мерчантом — заблокировать можно только свой кошелёк.
• Средства, уже полученные на заблокированный кошелёк, можно вернуть через POST /v1/wallet/blocked-address-refund.

---

​

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

POST /v1/wallet/blocked-address-refund

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