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 на момент ответа и может немного отличаться от значения при следующем запросе.