Carteira

Consultar Saldo

GET/v1/wallet/balance

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Autenticação

bearerAuthorizationstring · header · obrigatório

Envie no header:

Authorization: Bearer {{token}}

Retorna o saldo disponível e a atualizar na carteira da conta autenticada.

Consultar saldo da carteira

Retorna o saldo disponível para saque, o saldo pendente (pagamentos ainda sendo processados) e o total da conta. Contas M2M podem consultar o saldo de subcontas passando accountId.

Parâmetro	Obrig.	Descrição
`accountId`	❌	M2M: número da subconta ou lista separada por vírgula

← Anterior

Listar Subcontas

Listar Transações

const url = 'https://sandbox.validapay.com.br/v1/wallet/balance?accountId=';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200 conta própria

{
  "availableBalance": 150.0,
  "pendingBalance": 30.0,
  "totalBalance": 180.0
}

200200 M2M multi-conta

{
  "masterAccountId": "m_xxx",
  "balances": [
    {
      "accountNumber": "123456",
      "name": "Subconta A",
      "balance": 100.0
    }
  ]
}

404404

{
  "code": "ACCOUNT_NOT_FOUND"
}

← Anterior

Listar Subcontas

Listar Transações