Saques

Listar saques

Com esta funcionalidade você pode consultar o histórico e o status dos saques da sua master account ou de uma subconta associada a ela.

GET/v1/wallet/withdrawals

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

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

Use esta rota para acompanhar um saque que retornou PROCESSING no POST /v1/wallet/withdraw: localize o withdrawalId na lista e confira o status. Os saques vêm do mais recente para o mais antigo.

Status do saque

PROCESSING: PIX enviado, aguardando a confirmação da liquidação.
CONFIRMED: PIX liquidado na conta de destino.
ERROR: o PIX foi aceito para envio, mas a liquidação falhou.

⚠️ Atenção: um saque recusado no próprio POST /v1/wallet/withdraw (resposta 4xx) não é registrado e não aparece nesta lista. Só aparecem os saques aceitos para envio do PIX.

Authorizations

bearer

Authorization

string obrigatório

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

Escopos requeridos

wallet/read

Query Parameters

accountIdopcional

Número da subconta a consultar. Omitido, consulta a própria conta do token

258965356

statusopcional

PROCESSING, CONFIRMED ou ERROR

PROCESSING

startDateopcional

Data inicial (ISO 8601), comparada com a data de criação do saque

2026-10-01

endDateopcional

Data final (ISO 8601), inclusiva. Envie junto com startDate

2026-10-24

limitopcional

1 a 100, padrão 20

lastKeyopcional

Cursor da próxima página (pagination.lastKey da resposta anterior)

eyJhY2NvdW50SWQiOiIyNTg5NjUzNTYiLCJTSyI6IjIwMjYtMTAtMjRUMTQ6MTY6NDYuMDAwWiN3ZHJfMTc5Mjg1MTAwNjAwMF9hYjEyY2QzNGUifQ

← Anterior

Saque master account

Extrato subconta

const url = 'https://sandbox.validapay.com.br/v1/wallet/withdrawals?accountId=258965356&status=PROCESSING&startDate=2026-10-01&endDate=2026-10-24&limit=20';

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▾

JSON

{
    "items": [
        {
            "withdrawalId": "wdr_1792851006000_ab12cd34e", 
            "accountId": "258965356", 
            "amount": 150.00, 
            "feeAmount": 0.47, 
            "feeDeduction": { 
                "status": "COMPLETED", 
                "amount": 0.47, 
                "settledFromDebt": false, 
                "timestamp": "2026-10-24T14:16:52.120Z" 
            },
            "status": "CONFIRMED", 
            "pixKey": "12345678000190", 
            "pixKeyType": "CNPJ", 
            "documentNumber": "12345678000190", 
            "endToEndId": "E13935893202610241416abcdef12345", 
            "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", 
            "creditParty": { 
                "bank": "18236120", 
                "key": "12345678000190", 
                "branch": "0001", 
                "account": "1234567", 
                "name": "EMPRESA EXEMPLO LTDA", 
                "accountType": "CACC" 
            },
            "createdAt": "2026-10-24T14:16:46.000Z", 
            "updatedAt": "2026-10-24T14:16:52.120Z" 
        },
        {
            "withdrawalId": "wdr_1792847000000_fg56hi78j",
            "accountId": "258965356",
            "amount": 80.00,
            "feeAmount": 0.47,
            "feeDeduction": null,
            "status": "PROCESSING",
            "pixKey": "11111111-2222-3333-4444-555555555555",
            "pixKeyType": "EVP",
            "documentNumber": "12345678000190",
            "endToEndId": "E13935893202610241310klmnop67890",
            "transactionId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "creditParty": {
                "bank": "60701190",
                "key": "11111111-2222-3333-4444-555555555555",
                "branch": "0001",
                "account": "7654321",
                "name": "EMPRESA EXEMPLO LTDA",
                "accountType": "CACC"
            },
            "createdAt": "2026-10-24T13:10:00.000Z",
            "updatedAt": "2026-10-24T13:10:00.000Z"
        }
    ],
    "pagination": {
        "limit": 20, 
        "hasMore": true, 
        "lastKey": "eyJhY2NvdW50SWQiOiIyNTg5NjUzNTYiLCJTSyI6IjIwMjYtMTAtMjRUMTM6MTA6MDAuMDAwWiN3ZHJfMTc5Mjg0NzAwMDAwMF9mZzU2aGk3OGoifQ" 
    }
}

Campos da resposta

itemsarray[2]

paginationobject

404Subconta não encontrada▾

JSON

{
    "error": {
        "message": "Subconta 499999999 nao encontrada",
        "code": "SUBACCOUNT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-24T14:20:11.512Z"
    }
}

401Subconta de outra master account▾

JSON

{
    "error": {
        "message": "Subconta 499999999 nao pertence a esta conta master",
        "code": "UNAUTHORIZED_SUBACCOUNT",
        "details": null,
        "timestamp": "2026-10-24T14:21:03.877Z"
    }
}

401Credencial de outro ambiente▾

JSON

{
    "error": {
        "message": "Credencial inválida neste ambiente",
        "code": "INVALID_CREDENTIAL",
        "details": null,
        "timestamp": "2026-10-24T14:22:40.004Z"
    }
}

← Anterior

Saque master account

Extrato subconta