Este artigo explica para que serve o Pix Balance e com que frequência a API de consulta de saldo deve ser chamada.
O que é o Pix Balance?
O Pix Balance permite consultar o saldo disponível da sua conta dentro da Stark Infra, ou seja, o valor atualmente disponível para realizar operações.
Essa consulta é útil para:
Monitorar o saldo operacional da conta Pix na Stark Infra
Verificar se há saldo disponível antes de iniciar um Pix Out
Acompanhar variações de saldo ao longo da operação
Como funciona a consulta de saldo?
A rota GET /v2/pix-balance funciona no modelo de long polling:
A Stark Infra consulta o saldo disponível da sua conta
A requisição pode permanecer aberta por até 30 segundos
Assim que há uma resposta, o saldo é retornado
Com que frequência devo chamar essa API?
Não é recomendado chamar essa API em intervalos menores que 30 segundos.
Chamadas muito frequentes (por exemplo, a cada segundo) não trazem benefício, pois:
O saldo não muda instantaneamente a cada chamada
A requisição anterior pode ainda estar em processamento
Pode haver acúmulo desnecessário de chamadas
Em caso de dúvidas, ficamos à disposição.
Comentários
0 comentário
Artigo fechado para comentários.