> For the complete documentation index, see [llms.txt](https://docs.tupayonline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tupayonline.com/documentacion-de-la-api/conciliacion/balance-actual.md).

# Balance Actual

#### Descripción general

Este endpoint permite **consultar el balance actual del comercio** en la plataforma Tupay.\
El servicio retorna la información de saldos **por moneda**, incluyendo el **saldo total**, **saldo disponible**, y los **montos en proceso de liquidación**, lo que lo hace ideal para **conciliación financiera**, validaciones operativas y monitoreo de fondos.

La respuesta puede incluir uno o varios balances, dependiendo de la configuración del comercio (por ejemplo, múltiples monedas o tipos de cuenta).

#### Endpoint

<mark style="color:$success;">`GET STAGING`</mark> [`https://merchants-api-stg.tupayonline.com/v1/balance`](https://merchants-api.tupayonline.com/v1/deposits)

<mark style="color:$success;">`GET PRODUCCION`</mark> [`https://merchants-api.tupayonline.com/v1/balance`](https://merchants-api.tupayonline.com/v1/deposits)

#### Autenticación

El endpoint requiere autenticación mediante **headers de autorización** provistos por Tupay (por ejemplo, API Key / Bearer Token), los cuales deben ser enviados en cada solicitud

#### Response

<table><thead><tr><th width="342">Campo</th><th width="149">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>balances</code></td><td>array</td><td>Lista de balances asociados al comercio.</td></tr><tr><td><code>balances.currency</code></td><td>string</td><td>Moneda del balance (ej. <code>PEN</code>).</td></tr><tr><td><code>balances.type</code></td><td>string</td><td>Tipo de balance (ej. <code>PRIMARY</code>).</td></tr><tr><td><code>balances.data</code></td><td>object</td><td>Información detallada del balance.</td></tr><tr><td><code>balances.data.totalBalance</code></td><td>number</td><td>Saldo total de la cuenta.</td></tr><tr><td><code>balances.data.availableBalance</code></td><td>number</td><td>Saldo disponible para uso o retiro.</td></tr><tr><td><code>balances.data.depositSettlementPeriod</code></td><td>number</td><td>Monto correspondiente a depósitos en proceso de liquidación.</td></tr><tr><td><code>balances.data.accountNumber</code></td><td>string</td><td>Número de cuenta asociado al balance.</td></tr><tr><td><code>hasWallet</code></td><td>boolean</td><td>Indica si el comercio tiene una billetera habilitada.</td></tr><tr><td><code>hasRolling</code></td><td>boolean</td><td>Indica si el comercio tiene un esquema de rolling habilitado.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tupayonline.com/documentacion-de-la-api/conciliacion/balance-actual.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.