# Депозиты компании

Пополнение баланса компании через USDT TRC-20 переводы.

## Получение адреса кошелька


```bash
curl -X GET 'https://b2b.lumowallet.io/wallets' \
  -H 'X-API-Key: YOUR_API_KEY'
```

Ответ:


```json
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "createdAt": "2026-01-15T10:00:00Z"
}
```

Кошелёк создаётся автоматически при первом запросе.

## Пополнение баланса

1. Отправьте **USDT TRC-20** на адрес `address`
2. Дождитесь подтверждения в сети TRON
3. Система автоматически обработает депозит


## Проверка баланса


```bash
curl -X GET 'https://b2b.lumowallet.io/wallets/balance' \
  -H 'X-API-Key: YOUR_API_KEY'
```

Ответ:


```json
{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "usdtBalance": 1000.50,
  "trxBalance": 100.00
}
```

- `usdtBalance` — доступный баланс USDT для операций
- `trxBalance` — баланс TRX (для комиссий сети)


## Жизненный цикл депозита


```
new → fee_charged → aml_pending → aml_passed → forwarding → completed
                               └→ aml_failed
```

### Статусы

| Статус | Описание |
|  --- | --- |
| `new` | Депозит обнаружен в сети |
| `on_hold_insufficient_balance` | Недостаточно TRX для комиссии |
| `fee_charged` | Комиссия удержана |
| `aml_pending` | AML-проверка в процессе |
| `aml_passed` | AML-проверка пройдена |
| `aml_failed` | AML-проверка не пройдена |
| `forwarding` | Пересылка на treasury |
| `sweeping` | Sweep транзакция |
| `completed` | Депозит зачислен |
| `failed` | Ошибка обработки |


## AML-проверка

Каждый входящий депозит проходит автоматическую AML-проверку:

- **Проверяется:** адрес отправителя, история транзакций
- **Время:** обычно несколько секунд
- **При успехе:** статус `aml_passed`, средства зачисляются
- **При неудаче:** статус `aml_failed`, средства заблокированы


## Комиссия

Комиссия удерживается из суммы депозита (не с баланса):


```
Зачислено = Сумма депозита - Комиссия
```

Актуальные тарифы уточняйте у менеджера.

## История депозитов


```bash
curl -X GET 'https://b2b.lumowallet.io/wallets/deposits?status=completed&limit=50' \
  -H 'X-API-Key: YOUR_API_KEY'
```

Ответ:


```json
{
  "deposits": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "txHash": "abc123...",
      "amount": 100.00,
      "status": "completed",
      "fromAddress": "TXyz...",
      "sweepTxHash": "def456...",
      "blockTimestamp": "2026-03-10T12:00:00Z",
      "createdAt": "2026-03-10T12:00:05Z"
    }
  ],
  "total": 1
}
```

## Webhooks

При изменении статуса депозита отправляется webhook:


```json
{
  "event": "deposit.completed",
  "depositId": "550e8400-e29b-41d4-a716-446655440000",
  "txHash": "abc123...",
  "walletAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "fromAddress": "TXyz...",
  "amount": 100.00,
  "tokenSymbol": "USDT",
  "status": "completed",
  "createdAt": "2026-03-10T12:00:05Z"
}
```

События депозитов:

- `deposit.created`
- `deposit.fee_charged`
- `deposit.aml_pending`
- `deposit.completed`
- `deposit.failed`
- `deposit.aml_failed`


## Рекомендации

1. **Минимальная сумма** — уточните у менеджера
2. **Только USDT TRC-20** — другие токены не поддерживаются
3. **Проверяйте адрес** — переводы на неверный адрес невозвратны
4. **AML-блокировки** — свяжитесь с поддержкой для разбора