> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunnipay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Consulte o contrato Bunni antes de sugerir chamadas. Valores monetários são inteiros em centavos. Não invente endpoints ou respostas de sucesso para recursos ainda indisponíveis. Nunca solicite chaves reais no chat nem exponha credenciais no cliente.

# Carteiras

> Consulte saldos e organize os recebimentos.

Crie carteiras na sua conta Bunni e consulte os saldos disponíveis e reservados de cada uma.

## GET /v1/wallets

Permissão: `wallets:read`.

Retorna `data.items` com:

* `id`: identificador da carteira.
* `name`: nome.
* `isPrimary`: indica a carteira principal.
* `availableCents`: saldo disponível.
* `reservedCents`: saldo reservado.

A carteira principal aparece primeiro. A resposta inclui apenas carteiras da conta autenticada.

## POST /v1/wallets

Permissão: `wallets:write`. Retorna HTTP 200.

```json theme={"theme":"github-dark-default"}
{ "name": "Reserva" }
```

`name` é obrigatório, entre 2 e 48 caracteres. O nome deve ser único na conta. Nome duplicado retorna `409 WALLET_EXISTS`.

A resposta contém `data.id`, `data.name` e `data.isPrimary`. Criar uma carteira não transfere saldo.

Use o `id` retornado como `walletId` nas operações que aceitam uma carteira de destino.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.