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

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

---

​

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

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

Поскольку тройка (currency, network, order_id) идемпотентна, один order_id удобно закрепить за клиентом как его персональный адрес пополнения — см. Статические кошельки.

Статические кошельки не экономят на комиссии — она удерживается по вашей ставке (по умолч. ~1.5 %), как и на инвойсе. Кошельки — для пополнений/депозитов (напр. балансы пользователей), а не для разовых продаж товаров. Для продаж используйте инвойс (/v1/payment) — он даёт сумму, срок и статус конкретного заказа.

---

​

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

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

uuid · string

Идентификатор кошелька. Нужен для возврата.

address · string

Постоянный адрес приёма.

network · string

Сеть.

currency · string

Валюта.

order_id · string

Ваш идентификатор клиента/заказа.

url · string

Зарезервировано (обычно пусто).

---

​

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

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

{
  "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
}

Формат заголовков и проверка подписи — Объект вебхука.

---

​

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

POST /v1/wallet

создать кошелёк.

POST /v1/wallet/block

заблокировать.

POST /v1/wallet/blocked-address-refund

вернуть средства.

Статические кошельки

сценарий использования.