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

{
  "statusCode": 200,
  "message": "Saldo do comerciante encontrado com sucesso",
  "data": {
    "balance": 2450
  }
}

​
Visão Geral

Este endpoint permite obter o saldo atual do merchant autenticado. O saldo é retornado em centavos e representa o valor disponível na wallet principal do merchant.

​
Autenticação

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

{
  "statusCode": 200,
  "message": "Saldo do comerciante encontrado com sucesso",
  "data": {
    "balance": 2450
  }
}

​
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 do merchant
​
data.balance
integer
Saldo do merchant em centavos (2450 = R$ 24,50)
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 = 2450; // Resposta da API
const balanceInReais = balanceInCents / 100; // R$ 24,50

​
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 com split são pagas
  • Transferências são recebidas na wallet do merchant
  • Outros merchants fazem transferências para esta wallet