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

amountnumberRequired

Valor do saque

pixKeystringRequired

Chave Pix de destino

pixKeyTypestringRequired

Valores aceitos:CPFCNPJEMAILPHONEEVP

tipo de chave Pix

accountIdstringRequired

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