GET /v1/balance devolve quatro números. Eles não são variações do mesmo valor — cada um responde
uma pergunta diferente.
withdrawable é o número do saque
É este que vale para pedir saque, e não available.
Usar só o nosso disponível permitiria pedir dinheiro que a adquirente ainda não liberou — o pedido
passaria por aqui e falharia lá, depois, sem nada que o vendedor pudesse fazer a respeito.
reserved existe para que a diferença entre balance e available não pareça bug do sistema. É
dinheiro do vendedor que ainda não pode sair.
null não é zero
Quando a consulta ao provedor falha, provider e withdrawable vêm null:
Provedor não respondeu
Saldo negativo e debt
balance pode ser negativo. Acontece quando um estorno chega depois do saque:
Vendedor no vermelho
debt é estado próprio: as próximas vendas cobrem a dívida
automaticamente, e apenas o saque fica bloqueado até lá. As cobranças continuam funcionando
normalmente.
available nunca é negativo — a dívida aparece em debt, não como um disponível abaixo de zero.
O bloco provider
provider.available é o que já está disponível na adquirente; provider.waiting_funds é o que está
a caminho. Servem para explicar ao vendedor por que withdrawable é menor que available: o
dinheiro existe, ainda não chegou.
Veja também
Estornos
Como o saldo fica negativo.
withdrawal.paid
O evento que avisa quando o saque cai na conta.
Ficou algo de fora? Escreva para suporte@usevext.com. Se o assunto for uma chamada específica, informe o horário dela; se for uma entrega de webhook, informe o
X-Vext-Delivery — é por ele que localizamos a tentativa, a resposta do seu servidor e o horário.