Skip to main content
GET
https://api.pronttus.com.br
/
v1
/
banking
/
balance
curl -X GET https://api.pronttus.com.br/v1/banking/balance \
  -H "Authorization: Bearer seu_token"

{
  "statusCode": 200,
  "message": "Saldo da conta encontrado com sucesso.",
  "data": {
    "balance": 2493
  }
}

​
Visão Geral

Este endpoint permite verificar o saldo atual da conta bancária. O saldo é retornado em centavos e representa o valor disponível na conta.
O saldo é atualizado em tempo real e reflete todas as transações realizadas, incluindo recebimentos, transferências e saques.

​
Autenticação

​
Authorization
string
required
Token Bearer obtido no endpoint de autenticação Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6Ikp...
curl -X GET https://api.pronttus.com.br/v1/banking/balance \
  -H "Authorization: Bearer seu_token"

{
  "statusCode": 200,
  "message": "Saldo da conta encontrado com sucesso.",
  "data": {
    "balance": 2493
  }
}

​
Campos da Resposta

​
statusCode
integer
Código de status HTTP da resposta (200)
​
message
string
Mensagem de sucesso da operação
​
data
object
Dados do saldo da conta
​
data.balance
integer
Saldo da conta em centavos (2493 = R$ 24,93)
O valor do saldo é retornado em centavos. Para converter para reais, divida por 100.

​
Como Usar o Saldo

​
Conversão de Centavos para Reais

const balanceInCents = 2493; // Resposta da API
const balanceInReais = balanceInCents / 100; // R$ 24,93

​
Verificação de Saldo Disponível

Use este endpoint para verificar se há saldo suficiente antes de:
  • Realizar transferências
  • Processar saques
  • Validar operações que dependem do saldo

​
Monitoramento de Recebimentos

O saldo aumenta automaticamente quando:
  • Transações PIX são pagas
  • Transferências são recebidas na conta
  • Outras operações de crédito são processadas