Subcontas ValidaPay

Saldo subcontas

Com esta funcionalidade você pode verificar o saldo de uma ou várias subcontas

⚠️ Atenção: Para consultar o saldo de várias subcontas envie o header acoountId com o número das subcontas separado por vírgula, por exemplo: 9489623,9489624,9489625

GET/v1/wallet/balance

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

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

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

wallet/read

Query Parameters

Name	Type	Value	Required	Description
accountId	-	9489623	Required	Número da subconta. Para consultar o saldo de várias subcontas envie separado por virgula

← Anterior

Listar cobranças

Checkout Transparente

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

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

200Sucesso

{
    "masterAccountId": "429131313",
    "balances": [
        {
            "accountNumber": "459013888",
            "name": "VALIDAPAY PAGAMENTOS TECNOLOGIA E SERVICOS",
            "balance": 54.81
        },
        {
            "accountNumber": "460851986",
            "name": "VALIDA PIX",
            "balance": 196.82
        }
    ]
}

401Acesso negado

{
    "error": {
        "message": "Subconta 436514888 nao pertence a esta conta master",
        "code": "UNAUTHORIZED_SUBACCOUNT",
        "details": null,
        "timestamp": "2026-03-17T03:45:53.738Z"
    }
}

404Subconta não encontrada

{
    "error": {
        "message": "Subconta 459013666 nao encontrada",
        "code": "SUBACCOUNT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-03-17T03:46:49.577Z"
    }
}

← Anterior

Listar cobranças

Checkout Transparente