> For the complete documentation index, see [llms.txt](https://docs.esimpay.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.esimpay.net/api/balans.md).

# Баланс

Запросы баланса в реальном времени для аккаунта мерчанта.

Получение баланса мерчанта и доступных средств.

## Получить баланс мерчанта

> \
> Возвращает текущий баланс мерчанта.  \
> Требуется аутентификация через заголовок \`CF-MERCHANT-ID\`.  \
> Возвращает сумму доступных средств в валюте депозита мерчанта.<br>

```json
{"openapi":"3.1.1","info":{"title":"API","version":"v1"},"tags":[{"name":"Balance","description":"Получение баланса мерчанта и доступных средств."}],"servers":[{"url":"https://api.esimpay.net/api/v1"}],"paths":{"/customer/balance":{"get":{"operationId":"get_balance","summary":"Получить баланс мерчанта","description":"\nВозвращает текущий баланс мерчанта.  \nТребуется аутентификация через заголовок `CF-MERCHANT-ID`.  \nВозвращает сумму доступных средств в валюте депозита мерчанта.\n","parameters":[{"schema":{"type":"string"},"name":"CF-MERCHANT-ID","in":"header","description":"Идентификатор мерчанта для аутентификации","required":true}],"responses":{"200":{"description":"Баланс успешно получен","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"description":"Статус запроса","type":"string"},"message":{"description":"Сообщение об ошибке (null при успехе)","type":["string","null"]},"balance":{"description":"Текущий баланс мерчанта (USDT)","type":"number"}}}}}},"401":{"description":"Ошибка аутентификации или общая ошибка","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"description":"Статус запроса","type":"string"},"message":{"description":"Описание ошибки","type":"string"}}}}}}},"tags":["Balance"]}}}}
```