Carteira

Listar Transações

GET/v1/wallet/transactions

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

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

Autenticação

bearerAuthorizationstring · header · obrigatório

Envie no header:

Authorization: Bearer {{token}}

Lista o extrato de transações da carteira com suporte a filtros por data e paginação.

Listar extrato da carteira

Retorna todos os lançamentos financeiros paginados: pagamentos recebidos, PIX enviados e recebidos, saques, repasses, estornos e taxas. Use os filtros para refinar o período ou o tipo de lançamento.

Parâmetro	Obrig.	Descrição
`limit`	❌	Quantidade por página (padrão 15)
`lastKey`	❌	Token de paginação retornado na resposta anterior
`startDate`	❌	Data inicial (ISO 8601)
`endDate`	❌	Data final (ISO 8601)
`type`	❌	`CREDIT` (entradas) ou `DEBIT` (saídas)
`category`	❌	`PAYMENT` `PIX_IN` `PIX_OUT` `WITHDRAWAL` `SPLIT_IN` `REFUND` `FEE_COLLECTION`
`accountId`	❌	M2M: conta específica

← Anterior

Consultar Saldo

Anotar Transação

const url = 'https://sandbox.validapay.com.br/v1/wallet/transactions?limit=15&lastKey=&startDate=&endDate=&type=&category=&accountId=';

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

200200

{
  "items": [
    {
      "transactionId": "txn_xxx",
      "type": "CREDIT",
      "category": "PAYMENT",
      "amount": 100.0,
      "title": "Pagamento PIX recebido",
      "paymentMethod": "PIX",
      "chargeId": "cha_xxx",
      "subscriptionId": null,
      "endToEndId": "E...",
      "customer": {
        "name": "João Silva",
        "taxId": "***.***.***-**",
        "customerId": "cus_xxx"
      },
      "grossAmount": 100.0,
      "feeAmount": 0.99,
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 15,
    "hasMore": true,
    "lastKey": "eyJ..."
  }
}

← Anterior

Consultar Saldo

Anotar Transação