{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"История баланса","description":"Журнал движений баланса компании: пополнения, списания за ордера, заморозки, возвраты и операции по картам. Выгрузка в CSV.","siteUrl":"https://b2b-app.lumowallet.io","lang":"ru-RU","keywords":"Lumo B2B, платёжный API, крипто-платежи, USDT, TRC-20, СБП QR, виртуальные карты VISA, выплаты в рублях","image":"https://b2b-app.lumowallet.io/og-cover.png","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Lumo B2B","url":"https://b2b-app.lumowallet.io","logo":"https://b2b-app.lumowallet.io/apple-touch-icon.png","description":"Крипто-платежи для бизнеса: приём по QR СБП, депозиты USDT, виртуальные VISA-карты и выплаты в рублях.","sameAs":["https://t.me/LumoB2B"]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"история-баланса","__idx":0},"children":["История баланса"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Журнал всех движений баланса компании: пополнения, списания за ордера,"," ","заморозки, возвраты, операции по картам. Это источник правды для сверки —"," ","именно здесь видно, когда деньги действительно двигались."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /wallets/balance-history?limit=50&before=2026-08-14T00:00:00Z\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"параметры","__idx":2},"children":["Параметры"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Параметр"},"children":["Параметр"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Тип"},"children":["Тип"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Описание"},"children":["Описание"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Точное совпадение по типу операции"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Только записи с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt >= from"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Только записи с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt <= to"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1–200, по умолчанию 50"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Курсор: записи с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt < before"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"пример","__idx":3},"children":["Пример"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://b2b.lumowallet.io/wallets/balance-history?from=2026-08-01&limit=100' \\\n  -H 'X-API-Key: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"entries\": [\n    {\n      \"id\": \"7f2b12a4-...\",\n      \"createdAt\": \"2026-08-14T10:00:00Z\",\n      \"operationType\": \"order_success_settlement\",\n      \"referenceId\": \"660e8400-e29b-41d4-a716-446655440001\",\n      \"balanceBefore\": 1052.63,\n      \"balanceAfter\": 1000.00,\n      \"deltaBalance\": -52.63,\n      \"frozenBefore\": 52.63,\n      \"frozenAfter\": 0,\n      \"deltaFrozen\": -52.63,\n      \"metadata\": { \"walletOrderId\": \"...\" }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"как-читать-запись","__idx":4},"children":["Как читать запись"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaBalance"]}]}," — изменение доступного баланса. Ноль означает, что деньги"," ","не двигались (например, только сняли заморозку)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaFrozen"]}]}," — изменение замороженной суммы. Заморозка не списание:"," ","средства ещё ваши, но недоступны, пока ордер в работе."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceId"]}]}," — к чему относится запись: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depositId"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rechargeId"]}," или ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardId"]},", в зависимости от типа операции. По нему сводятся"," ","движения с ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/orders/order-lifecycle"},"children":["ордерами"]}," и"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/disputes"},"children":["диспутами"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["balanceAfter"]}]}," — баланс сразу после операции, удобно для сверки."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"типы-операций","__idx":5},"children":["Типы операций"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Основные, которые встретятся в обычной работе:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"депозиты","__idx":6},"children":["Депозиты"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"operationType"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Описание"},"children":["Описание"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_deposit_credit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Депозит зачислен на баланс"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_deposit_fee_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Удержана комиссия за приём депозита"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ордера","__idx":7},"children":["Ордера"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"operationType"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Описание"},"children":["Описание"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_frozen_increase"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Сумма ордера заморожена при создании"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_success_settlement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ордер прошёл, сумма списана"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_failed_unfreeze"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ордер не прошёл, заморозка снята (списания не было)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_failed_refund_after_success"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Уже списанная сумма возвращена"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_success_settlement_after_dispute"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Диспут отклонён, списание подтверждено"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_partial_refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Возвращена часть суммы ордера"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"карты","__idx":8},"children":["Карты"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"operationType"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Описание"},"children":["Описание"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_request_freeze"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Резерв под выпуск карты"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_request_release"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Резерв освобождён (заявка отменена)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_opening_fee_debit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Комиссия за выпуск карты"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_recharge_debit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Списание за пополнение карты"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_recharge_refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Возврат пополнения"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_recharge_failed_refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Пополнение не прошло, средства возвращены"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card_closure_refund"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Остаток закрытой карты возвращён на баланс"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[":::note Не завязывайтесь на закрытый список"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Помимо перечисленных встречаются служебные записи ручных корректировок"," ","(например, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["admin_balance_topup"]},"). Список пополняется, поэтому не считайте"," ","неизвестный ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}," ошибкой — показывайте его как есть, а логику"," ","стройте на ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaBalance"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaFrozen"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[":::"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"выгрузка-в-csv","__idx":9},"children":["Выгрузка в CSV"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /wallets/balance-history.csv?from=2026-08-01&to=2026-08-14\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Отдаёт файл со всеми записями за период (а не одной страницей), с теми же"," ","фильтрами ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to"]},". UTF-8 с BOM — Excel открывает"," ","кириллицу корректно, имя файла приходит в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Disposition"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -OJ 'https://b2b.lumowallet.io/wallets/balance-history.csv?from=2026-08-01' \\\n  -H 'X-API-Key: YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Колонки: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operationType"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaBalance"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["balanceAfter"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deltaFrozen"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["frozenAfter"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenceId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"пагинация","__idx":10},"children":["Пагинация"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Курсорная: берёте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]}," последней записи и передаёте в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["before"]}," ","следующего запроса. Ответ короче ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," — значит конец. Для выгрузки за"," ","период используйте CSV: он не постраничный."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"права","__idx":11},"children":["Права"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Нужно право ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["balance.read"]},"."]}]},"headings":[{"value":"История баланса","id":"история-баланса","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Параметры","id":"параметры","depth":2},{"value":"Пример","id":"пример","depth":2},{"value":"Как читать запись","id":"как-читать-запись","depth":2},{"value":"Типы операций","id":"типы-операций","depth":2},{"value":"Депозиты","id":"депозиты","depth":3},{"value":"Ордера","id":"ордера","depth":3},{"value":"Карты","id":"карты","depth":3},{"value":"Выгрузка в CSV","id":"выгрузка-в-csv","depth":2},{"value":"Пагинация","id":"пагинация","depth":2},{"value":"Права","id":"права","depth":2}],"frontmatter":{"seo":{"description":"Журнал движений баланса компании: пополнения, списания за ордера, заморозки, возвраты и операции по картам. Выгрузка в CSV.","title":"История баланса"}},"lastModified":"2026-09-02T11:33:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/balance-history","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}