GET
/integration/balancesВозвращает балансы всех мерчантов ключа. Авторизация — обычным X-Api-Key (подпись не нужна). Все суммы леджера — целые числа в минорных единицах RUB (копейки). Ответ — на верхнем уровне, без обёртки data.
Авторизация — без подписи
Метод доступен по обычному ключу X-Api-Key, как и курсы. Заголовки X-Timestamp / X-Signature не требуются.
Пример
curl https://api.cashera.cash/api/v1/integration/balances \-H "X-Api-Key: $CASHERA_API_KEY"
Поля мерчанта
| Поле | Тип | Описание |
|---|---|---|
uuidопц. | string | Идентификатор мерчанта в Cashera. |
nameопц. | string | Системное имя мерчанта. |
titleопц. | string | Отображаемое название мерчанта. |
balancesопц. | array | Список балансов мерчанта по валютам (см. ниже). |
Поля баланса
| Поле | Тип | Описание |
|---|---|---|
uuidопц. | string | Идентификатор баланса. |
currencyопц. | string | Валюта баланса. Сейчас — RUB. |
pendingопц. | integer | Зачисления в обработке (ещё недоступны к выплате), минорные единицы. |
availableопц. | integer | Доступно к выплате прямо сейчас, минорные единицы. |
frozenопц. | integer | Заморожено (споры, ручные блокировки), минорные единицы. |
in_payoutопц. | integer | Зарезервировано под выплаты в статусе pending, минорные единицы. |
total_heldопц. | integer | Суммарно удержано (заморозка + резерв под выплаты), минорные единицы. |
lifetime_turnoverопц. | integer | Совокупный оборот по приёму за всё время, минорные единицы. |
lifetime_withdrawnопц. | integer | Совокупно выведено за всё время, минорные единицы. |
reconciliation_lockedопц. | boolean | Баланс заблокирован на время сверки — выплаты временно недоступны. |
usdt_equivalentопц. | object | null | Справочный USDT-эквивалент баланса по текущему курсу (см. ниже). Опционально. |
Поля usdt_equivalent
Справочный снимок того же баланса в USDT, рассчитанный по текущему курсу на момент ответа. Денежные поля — в микроюнитах USDT (6 знаков). Используйте для отображения, а не для расчётов с балансом.
| Поле | Тип | Описание |
|---|---|---|
currencyопц. | string | Валюта снимка — USDT. |
pendingопц. | integer | USDT-эквивалент pending (микроюниты). |
availableопц. | integer | USDT-эквивалент available (микроюниты). |
frozenопц. | integer | USDT-эквивалент frozen (микроюниты). |
in_payoutопц. | integer | USDT-эквивалент in_payout (микроюниты). |
total_heldопц. | integer | USDT-эквивалент total_held (микроюниты). |
lifetime_turnoverопц. | integer | USDT-эквивалент lifetime_turnover (микроюниты). |
lifetime_withdrawnопц. | integer | USDT-эквивалент lifetime_withdrawn (микроюниты). |
fx_rateопц. | string | Курс пересчёта в USDT, по которому посчитан снимок. |
fx_rate_updated_atопц. | string (ISO 8601) | Момент актуализации курса снимка. |
Леджер — в RUB, USDT — справочно
Денежные поля баланса хранятся в минорных единицах RUB (копейках). Блок usdt_equivalent — справочный снимок по текущему курсу fx_rate на момент ответа и может немного отличаться от значения при следующем запросе.