Exibir saldo do estabelecimento

Este endpoint retorna o saldo total, bloqueado e disponível de um estabelecimento específico. Pode ser utilizado para consultas em tempo real a fim de verificar valores disponíveis para saque ou bloqueados por alguma operação.

🔽

GET urlServidor/v1/marketplace/establishments/balance

Obs: A palavra urlServidor deve ser substituída pela url do servidor.

Parâmetros da Requisição

NomeTipoObrigatórioDescrição
integration-keystringSimChave de integração.
x-tokenstringSimToken de autenticação. Pode ser encontrado em nosso portal na guia de integração.
AuthorizationAuth Type Bearer TokenSimInserir o Bearer Token, gerado na rota Auth
establishment\_idstringSimID do estabelecimento ao qual os lançamentos estão vinculados.

Exemplo de header da requisição

curl --request GET \
  --url '{{urlServidor}}/v1/marketplace/establishments/balance' \
  --header 'integration-key: sua_integration_key' \
  --header 'x-token: seu_x_token' \
  --header 'establishment_id: 0000' \
  --header 'Accept: application/json

Exemplo do response

{
    "total_balance": 5000000,
    "blocked_balance": 0,
    "balance": 5000000
}

Descrição dos Campos do Response

CampoTipoObrigatórioDescrição
total_balancenumberSimSaldo total do estabelecimento, somando valores disponíveis e bloqueados (em centavos).
blocked_balancenumberSimSaldo bloqueado, indisponível para saque ou transferência (em centavos).
balancenumberSimSaldo disponível para saque ou uso imediato (em centavos).

Para mais informações, consulte a documentação oficial da Paytime.

Códigos de Resposta

Consulte a página com os status: Status de respostas

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.


Did this page help you?