Skip to main content
GET /v1/wallet devolve o saldo da loja separado por situação. A confusão comum é achar que “saldo” é o quanto dá pra sacar, e não é.

​
O que cada número significa

​
number
Saldo bruto da carteira, em reais. É o total que entrou e ainda não saiu, sem descontar retenção.
​
number
Valor retido por disputas abertas ou perdidas que ainda não foram perdoadas. Fica indisponível até a contestação ser resolvida.
​
number
É este que importa na hora de sacar. Vale balance - disputeBlocked, e é o teto aceito por POST /v1/payouts.
​
number
Vendas no cartão aguardando o prazo de liberação. Ainda não está em balance nem em withdrawable. É previsão de caixa, não dinheiro disponível.
​
number
Saldo em Litecoin, com 8 casas decimais. Sacável por POST /v1/payouts com method: "ltc".
Todos os valores em reais têm um par em centavos (balanceCents, withdrawableCents, pendingReleaseCents).
Use os campos em centavos para qualquer conta. Ponto flutuante em dinheiro é como você ganha uma diferença de um centavo no relatório e perde uma tarde procurando.

​
A relação entre eles

Pedir um saque acima de withdrawable devolve 400 por saldo insuficiente, mesmo que balance cubra o valor. Se isso te pegou de surpresa, quase sempre a resposta está em disputeBlocked.

​
Em sandbox

A rota funciona com chave ps_test_. O saldo é somado a partir das transações de teste, a resposta traz "sandbox": true, e disputeBlocked e cryptoBalanceLtc ficam sempre em zero.

Tirar o dinheiro

PIX, LTC ou USDT, direto pela API.

Destravar retenção

Como responder uma contestação e liberar o valor.