Saques

Saque subconta

Com esta funcionalidade você pode criar um saque em uma subconta associada à sua master account.

⚠️ Atenção: Só é possível fazer saques para contas de mesma titularidade

POST/v1/wallet/withdraw

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/write

Body

application/json

Content-Type:application/json

{
  "amount": 1.00,
  "pixKey": "12345678925",
  "pixKeyType": "CPF",
  "accountId": "258965356" 
}

Schema

Field	Type	Required	Description
amount	number	Required	Valor do saque
pixKey	string	Required	Chave Pix de destino
pixKeyType	string	Required	tipo de chave Pix
accountId	string	Required	Número da subconta de destino

← Anterior

Pagar em sandbox

Saque master account

const url = 'https://sandbox.validapay.com.br/v1/wallet/withdraw';

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {{token}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "amount": 1.00,
  "pixKey": "12345678925",
  "pixKeyType": "CPF",
  "accountId": "258965356" 
})
};

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

Response Examples

200Sucesso

{
    "withdrawalId": "wdr_1772883158760_tdhomd8xe",
    "status": "PROCESSING",
    "amount": 1,
    "accountNumber": "258965356"
}

401Acesso negado

{
    "error": {
        "message": "Subconta nao pertence a esta conta",
        "code": "OWNERSHIP_MISMATCH",
        "details": null,
        "timestamp": "2026-03-17T04:01:14.653Z"
    }
}

400Bloqueio por titularidade

{
    "error": {
        "message": "A chave PIX nao pertence ao titular da conta",
        "code": "OWNERSHIP_MISMATCH",
        "details": null,
        "timestamp": "2026-03-17T04:01:57.811Z"
    }
}

← Anterior

Pagar em sandbox

Saque master account