---
title: "$viva->wallets->balance()"
method: GET
path: "/Wallets/balance"
tags: ["Wallets"]
---

# $viva->wallets->balance()

`GET /Wallets/balance`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/docs/Wallets/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

Retourne le solde agrégé de tous les portefeuilles.

**API: Legacy** (agrège la réponse de `Wallets::list()` côté SDK).

```php
$balance = $viva->wallets->balance();

echo $balance['available'];  // 150.50
echo $balance['pending'];    // 25.00
echo $balance['reserved'];   // 0.00
echo $balance['currency'];   // 'EUR'
```

## Response `200`

Solde agrégé

- WalletBalance
  - `available` number, float: Solde disponible
  - `pending` number, float: Solde en attente
  - `reserved` number, float: Solde réservé
  - `currency` string: Code devise ISO 4217

## Changes

- **2026-03-18** `b25ecb15a272`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/changes/Wallets/balance/get.md)

---

[API](https://skmtc.dev/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php.md) - [All operations](https://skmtc.dev/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/llms.txt) - [OpenAPI document](https://skmtc.dev/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/revisions/bcafd06ce584?raw)