> ## Documentation Index
> Fetch the complete documentation index at: https://oblodai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/wallet/block

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

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

<Note>
  Примеры используют хелпер `call()` и переменные `$SECRET`/`$PUBLIC_ID` — их определение см. в
  [Как подписать запрос](/guides/signing-requests). Проще не писать подпись руками, а взять
  [SDK](/sdk/overview).
</Note>

***

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

<ParamField body="address" type="string" required>
  Адрес статического кошелька.
</ParamField>

<ParamField body="is_force_block" type="bool" default={true}>
  `true` — заблокировать (значение по умолчанию, если поле опущено); `false` — снять блокировку.
</ParamField>

***

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

<CodeGroup>
  ```bash cURL theme={null}
  # Заблокировать
  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"
  ```

  ```python Python theme={null}
  call("/v1/wallet/block", {"address": "TXk9...c3Fd"})                       # заблокировать
  call("/v1/wallet/block", {"address": "TXk9...c3Fd", "is_force_block": False})  # разблокировать
  ```

  ```js Node.js theme={null}
  await call("/v1/wallet/block", { address: "TXk9...c3Fd" });                        // заблокировать
  await call("/v1/wallet/block", { address: "TXk9...c3Fd", is_force_block: false }); // разблокировать
  ```
</CodeGroup>

***

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

```json theme={null}
{ "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`](/reference/wallet-blocked-refund).

***

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

<CardGroup cols={2}>
  <Card title="POST /v1/wallet/blocked-address-refund" href="/reference/wallet-blocked-refund" icon="arrow-right" horizontal />

  <Card title="Объект кошелька" href="/reference/wallet-object" icon="arrow-right" horizontal />
</CardGroup>