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

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

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

Ответ:

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

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

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

Комиссии за пополнение нет: на баланс зачисляется вся сумма депозита.

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

Ответ:

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "usdtBalance": 1000.5,
  "trxBalance": 0,
  "frozenBalance": 52.63,
  "availableBalance": 947.87
}

new → fee_charged → aml_pending → completed
                         └─→ pending_retry → … → failed

Если AML-проверка не пройдена или обработка сорвалась, депозит уходит в pending_retry и повторяется через 5 минут, 1 час и 4 часа; если все три попытки не удались — failed, причина в error (например, AML check failed (…)).

Если AML-проверка для депозитов компании выключена, депозит идёт по другому пути: new → fee_charged → aml_passed → forwarding → completed, а amlResult начинается со skipped. aml_passed и forwarding — промежуточные статусы, вебхуков на них нет.

Статусы aml_failed, on_hold_insufficient_balance и sweeping есть в перечислении, но депозитам на адрес компании сейчас не выставляются.

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

• При успехе: депозит зачисляется, приходит deposit.completed.
• При неудаче: проверка повторяется по расписанию выше; если и после повторов она не пройдена, депозит не зачисляется, приходит deposit.failed. Для разбора напишите в поддержку.

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

Ответ:

{
  "deposits": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "txHash": "a3f1c9...e07b",
      "amount": 100,
      "status": "completed",
      "fromAddress": "TXyz4b8XqQ1wR9mJ2vL5kN7pC3dF6gH8jK",
      "sweepTxHash": "b81e0d...44c2",
      "error": null,
      "blockTimestamp": "2026-03-10T12:00:00.000Z",
      "createdAt": "2026-03-10T12:00:05.000Z"
    }
  ],
  "total": 1
}

Новые депозиты — первыми. total — число депозитов с учётом фильтра.

На каждом шаге приходит событие с полным состоянием депозита: deposit.created, deposit.fee_charged, deposit.aml_pending, затем deposit.completed или deposit.failed.

{
  "event": "deposit.completed",
  "depositId": "550e8400-e29b-41d4-a716-446655440000",
  "txHash": "a3f1c9...e07b",
  "walletAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "fromAddress": "TXyz4b8XqQ1wR9mJ2vL5kN7pC3dF6gH8jK",
  "amount": 100,
  "tokenSymbol": "USDT",
  "status": "completed",
  "amlCheckId": null,
  "amlResult": null,
  "sweepTxHash": "b81e0d...44c2",
  "error": null,
  "blockTimestamp": "2026-03-10T12:00:00.000Z",
  "createdAt": "2026-03-10T12:00:05.000Z",
  "updatedAt": "2026-03-10T12:00:41.000Z"
}

deposit.completed уходит чуть раньше, чем средства появляются на балансе: зачисление идёт сразу следующим шагом. Само зачисление видно в истории баланса как company_deposit_credit.

Подробнее о полях и подписи — в разделе Webhooks.

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