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 · escopo balance:read

curl https://bukio-backend-production.up.railway.app/v1/balance \
  -H "Authorization: Bearer bk_live_..."

{
  "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.

​

Prévia da tarifa

GET /v1/fees/preview?operation=WITHDRAWAL&amount=10000 · escopo balance:read

{ "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.