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

# Saldo e tarifas

> Saldo disponível, bloqueado, o valor mínimo do saque e a prévia da tarifa de uma operação.

## Consultar o saldo

[`GET /v1/balance`](https://docs.wyzecash.com.br/referencia/saldo/consultar-saldo) · escopo `balance:read`

```bash theme={null}
curl https://api.wyzecash.com.br/v1/balance \
  -H "Authorization: Bearer bk_live_..."
```

```json theme={null}
{
  "available": 184250,
  "pending": 0,
  "blocked": 5000,
  "medOwed": 0,
  "withdrawal": { "minPerTransaction": 100 },
  "updatedAt": "2026-10-08T14:58:03.120Z"
}
```

| Campo | O que é |
| - | - |
| `available` | o que pode ser sacado ou enviado agora (centavos) |
| `pending` | a liberar: vendas no cartão já aprovadas (líquido da tarifa) que entram no disponível 15 dias depois da aprovação (D+15) |
| `blocked` | retido por pedidos de devolução (MED) em aberto |
| `medOwed` | MED devolvido sem saldo suficiente: o que ainda falta cobrir; os próximos recebimentos descontam antes de ficar disponível |
| `withdrawal.minPerTransaction` | o menor saque ou Pix enviado da sua conta (centavos) |
| `updatedAt` | última mudança no saldo |

O saldo é a sua posição atual; para o histórico, use o [extrato](https://docs.wyzecash.com.br/endpoints/transacoes.md).

## Prévia da tarifa

[`GET /v1/fees/preview?operation=WITHDRAWAL&amount=10000`](https://docs.wyzecash.com.br/referencia/saldo/previa-tarifa) · escopo `balance:read`

```json theme={null}
{ "operation": "WITHDRAWAL", "amount": 10000, "fee": 50 }
```

| `operation` | Operação |
| - | - |
| `PIX_CHARGE` | cobrança paga no Pix (a tarifa sai do valor recebido) |
| `CARD_CHARGE` | venda no cartão de crédito (percentual + fixo) |
| `CRYPTO_CHARGE` | pagamento em cripto (percentual + fixo) |
| `WITHDRAWAL` | todo Pix que sai: saque (painel, app ou API), Pix enviado e Copia e Cola, com a mesma tarifa |
| `CRYPTO_WITHDRAWAL` | saque em cripto (USDT) |
| `INTERNAL_TRANSFER` | transferência entre contas WyzeCash |
| `MED` | pedido de devolução recebido |

A tarifa que vale é sempre a calculada pela WyzeCash na hora da operação: a prévia serve para mostrar ao usuário antes de confirmar. O nome antigo `PIX_SENT` ainda é aceito e responde com a tarifa de `WITHDRAWAL`. Operação desconhecida responde `422 INVALID_OPERATION`.


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