Extratos

Extrato subconta

Com esta funcionalidade você pode isualizar movimentações em uma subconta associada a sua master account

GET/v1/wallet/transactions

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

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

Escopos requeridos

wallet/read

Query Parameters

Name	Type	Value	Required	Description
accountId	-	460851686	Required	- ID da subconta a consultar
type	-	CREDIT	Optional	- CREDIT ou DEBIT
category	-	PAYMENT	Optional	- PAYMENT, PIX_IN, WITHDRAWAL, etc.
dateFrom	-	2026-03-01T00:00:00Z	Optional	- Data início (ISO 8601)
dateTo	-	2026-03-16T23:00:00Z	Optional	- Data fim (ISO 8601)
limit	-	5	Optional	- 1-100, default 50
nextPageToken	-	eyJTSyI6IjIwMjYtMDMtMTRUMjM6MjM6MzYuMDk2WiN0eG5fMTc3MzUzMDYxNjA5Nl8zOXdmbTk5aTQiLCJhY2NvdW50SWQiOiI0MjkxMzEyMTIifQ	Optional	- Token de paginação

← Anterior

Saque master account

Extrato conta master

const url = 'https://sandbox.validapay.com.br/v1/wallet/transactions?accountId=460851686&type=CREDIT&category=PAYMENT&dateFrom=2026-03-01T00:00:00Z&dateTo=2026-03-16T23:00:00Z&limit=5&nextPageToken=eyJTSyI6IjIwMjYtMDMtMTRUMjM6MjM6MzYuMDk2WiN0eG5fMTc3MzUzMDYxNjA5Nl8zOXdmbTk5aTQiLCJhY2NvdW50SWQiOiI0MjkxMzEyMTIifQ?accountId=460851686&type=CREDIT&category=PAYMENT&dateFrom=2026-03-01T00%3A00%3A00Z&dateTo=2026-03-16T23%3A00%3A00Z&limit=5&nextPageToken=eyJTSyI6IjIwMjYtMDMtMTRUMjM6MjM6MzYuMDk2WiN0eG5fMTc3MzUzMDYxNjA5Nl8zOXdmbTk5aTQiLCJhY2NvdW50SWQiOiI0MjkxMzEyMTIifQ';

const options = {
  method: 'GET',
};

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

Response Examples

200Sucesso

{
    "accountId": "429134563",
    "transactions": [
        {
            "transactionId": "txn_1773694940975_r10b6fyzm",
            "type": "CREDIT",
            "category": "PIX_IN",
            "amount": 2.56,
            "balanceAfter": 901.6,
            "title": "PIX recebido de Malga",
            "paymentMethod": "PIX",
            "chargeId": null,
            "subscriptionId": null,
            "endToEndId": "E13935893202603162102IfDcitXf0zO",
            "counterparty": {
                "name": "Malga",
                "bank": "13935893",
                "taxId": "37134852000458",
                "account": "410900056"
            },
            "referenceId": "E139389320260316202IfDyytXf0zO",
            "description": "PIX recebido direto",
            "createdAt": "2026-03-16T21:02:20.975Z"
        },
        {
            "transactionId": "txn_1773718528326_449bqmhm7",
            "type": "DEBIT",
            "category": "WITHDRAWAL",
            "amount": 1,
            "balanceAfter": 929.85,
            "title": "Saque PIX",
            "paymentMethod": "PIX",
            "chargeId": null,
            "subscriptionId": null,
            "endToEndId": "E13935893202563270335KF9O0GDVVIz",
            "counterparty": null,
            "referenceId": "f7d1e875-7096-4fa8-992d-0c81a09f91c0",
            "description": "Saque / transferência PIX",
            "createdAt": "2026-03-17T03:35:28.326Z"
        },
    ],
    "nextPageToken": "eyJTSyI6IjIwMjYtMDMtMTVUMjM6NTk6MzMuMDcxWiN0eG5fMTc3MzYxOTE3MzA3MV8zb3JpcjNjYnciLCJhY2NvdW50SWQiOiI0MjkxMzEyMTIifQ",
    "hasMore": true
}

← Anterior

Saque master account

Extrato conta master