Skip to main content
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.
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.