Saldo e extrato

Consulte o saldo e o extrato da própria conta diretamente pela API — mesma MerchantApiKey do resto desta documentação, sem precisar de uma sessão de admin no Backoffice.

Consultar o saldo

cURL

curl https://api.tamino.com.br/v1/balance \
  -H "Authorization: Bearer sk_test_..."

TypeScript

const balance = await gateway.balance.get();

{
  "currency": "BRL",
  "availableInCents": 38000,
  "netInCents": 38000,
  "blockedInCents": 12000,
  "grossInCents": 50000
}

Campo	Significado
`availableInCents`	Use este como saldo. O disponível pra saque agora (mesmo valor de `netInCents`).
`netInCents`	O saldo de verdade — o que está disponível pra saque agora.
`blockedInCents`	Soma de valores bloqueados preventivamente (ex.: uma disputa MED em aberto — ver PIX disputes (MED)). Congelado até um admin decidir; nunca soma no disponível.
`grossInCents`	`netInCents + blockedInCents` — o que existiria se nada estivesse bloqueado agora. Não é saldo disponível.

Nota

netInCents já é o mesmo número usado internamente pra aceitar ou recusar um payout — um saque acima do saldo disponível é sempre rejeitado, independente do valor bruto/bloqueado.

Extrato

cURL

curl https://api.tamino.com.br/v1/balance/statement?limit=20 \
  -H "Authorization: Bearer sk_test_..."

TypeScript

const page = await gateway.balance.statement({ limit: 20 });

{
  "data": [
    {
      "id": "e4a1...",
      "accountId": "a9c2...",
      "direction": "debit",
      "amountInCents": 12000,
      "currency": "BRL",
      "description": "Bloqueio preventivo — disputa PIX nuvende, infração ...",
      "createdAt": "2026-09-16T12:04:11.000Z"
    },
    {
      "id": "9b0f...",
      "accountId": "a9c2...",
      "direction": "credit",
      "amountInCents": 50000,
      "currency": "BRL",
      "description": "Venda — checkout cf810b10-...",
      "createdAt": "2026-09-16T10:00:00.000Z"
    }
  ],
  "nextCursor": "OWIwZi0uLi4=",
  "hasMore": true
}

Um item por lançamento (venda, tarifa, saque, bloqueio/liberação de reserva, ...), mais recente primeiro. Paginação por cursor — mesmo formato do resto da API (cursor/limit/hasMore), ver Idempotência pra detalhes gerais de paginação. direction é sempre credit (aumenta o saldo) ou debit (reduz).

Limitação desta entrega

Esta página lista os lançamentos de uma conta só (a do merchant dono da chave usada) — não é um extrato consolidado multi-conta.