> ## 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.

# Объект кошелька (Wallet)

Статический кошелёк — это **постоянный адрес приёма**, закреплённый за мерчантом (и, по желанию, за
конкретным клиентом через `order_id`). В отличие от инвойса, у него нет фиксированной суммы и срока:
любое поступление сразу зачисляется на доступный баланс мерчанта.

***

## Чем статический кошелёк отличается от инвойса

|                          | Инвойс ([`/v1/payment`](/reference/payment-create)) | Статический кошелёк ([`/v1/wallet`](/reference/wallet-create))                                                       |
| ------------------------ | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Назначение               | Разовый счёт на фиксированную сумму.                | Постоянный адрес пополнения.                                                                                         |
| Сумма                    | Задаётся заранее.                                   | Не задаётся — принимается любая.                                                                                     |
| Срок жизни               | Ограничен (`lifetime`).                             | Бессрочный (до блокировки).                                                                                          |
| Что происходит с оплатой | Закрывает счёт.                                     | Зачисляется на **доступный баланс** мерчанта.                                                                        |
| Тип вебхука              | `payment` (событие `invoice.*`).                    | `wallet` (событие **`wallet.paid`**).                                                                                |
| Комиссия платформы       | Удерживается.                                       | **Удерживается** — по вашей ставке (по умолч. \~1.5 %); на баланс идёт нетто, а `payment_amount` в вебхуке — брутто. |
| Идемпотентность          | по `order_id`.                                      | по тройке `(currency, network, order_id)`.                                                                           |

Поскольку тройка `(currency, network, order_id)` идемпотентна, один `order_id` удобно закрепить за
клиентом как его **персональный адрес пополнения** — см. [Статические
кошельки](/guides/static-wallets).

<Note>
  **Статические кошельки не экономят на комиссии** — она удерживается по вашей ставке (по умолч.
  \~1.5 %), как и на инвойсе. Кошельки — для пополнений/депозитов (напр. балансы пользователей), а не
  для разовых продаж товаров. Для продаж используйте инвойс ([`/v1/payment`](/reference/payment-create)) — он
  даёт сумму, срок и статус конкретного заказа.
</Note>

***

## Пример объекта (ответ создания)

```json theme={null}
{
  "uuid": "0e5b6b9a-6a1e-4b7e-9d2b-2c1f4a8e9c11",
  "address": "TXk9...c3Fd",
  "network": "tron",
  "currency": "USDT",
  "order_id": "client-42",
  "url": ""
}
```

<ResponseField name="uuid" type="string">
  Идентификатор кошелька. Нужен для [возврата](/reference/wallet-blocked-refund).
</ResponseField>

<ResponseField name="address" type="string">
  Постоянный адрес приёма.
</ResponseField>

<ResponseField name="network" type="string">
  Сеть.
</ResponseField>

<ResponseField name="currency" type="string">
  Валюта.
</ResponseField>

<ResponseField name="order_id" type="string">
  Ваш идентификатор клиента/заказа.
</ResponseField>

<ResponseField name="url" type="string">
  Зарезервировано (обычно пусто).
</ResponseField>

***

## Вебхук пополнения

Каждое поступление на статический кошелёк порождает вебхук типа `wallet` с событием `wallet.paid`:

```json theme={null}
{
  "type": "wallet",
  "uuid": "0e5b6b9a-6a1e-4b7e-9d2b-2c1f4a8e9c11",
  "order_id": "client-42",
  "address": "TXk9...c3Fd",
  "network": "tron",
  "currency": "USDT",
  "payment_amount": "150.00",
  "payer_currency": "USDT",
  "txid": "9b1f...e4",
  "status": "paid",
  "is_final": true
}
```

Формат заголовков и проверка подписи — [Объект вебхука](/reference/webhook-object).

***

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

<CardGroup cols={2}>
  <Card title="POST /v1/wallet" href="/reference/wallet-create" icon="arrow-right" horizontal>
    создать кошелёк.
  </Card>

  <Card title="POST /v1/wallet/block" href="/reference/wallet-block" icon="arrow-right" horizontal>
    заблокировать.
  </Card>

  <Card title="POST /v1/wallet/blocked-address-refund" href="/reference/wallet-blocked-refund" icon="arrow-right" horizontal>
    вернуть средства.
  </Card>

  <Card title="Статические кошельки" href="/guides/static-wallets" icon="arrow-right" horizontal>
    сценарий использования.
  </Card>
</CardGroup>