# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.