Acessar minha contaAbrir uma conta
GET/api/v2/pix/pagamentos

Listar

Lista pagamentos Pix no contexto autenticado (resposta paginada). Scope: pix.read. Cada item segue PagamentoResource; recebedor/pagador podem vir como []. Status: "0" INICIADO, "9" CONFIRMADO, "-1" ERRO.

Parâmetros

AcceptObrigatório
header

Tipo de conteúdo aceito na resposta

Tipo:string

Autenticação e scopes

Requer Bearer token com scope pix.read.

Headers

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
AcceptSimapplication/json

Retorno 200

Envelope paginado:

CampoTipoDescrição
pagamentosarrayItens PagamentoResource
correlationIdstringCorrelação da requisição
currentPageintegerPágina atual
lastPageintegerÚltima página
perPageintegerItens por página
from / tointegerFaixa de itens na página
totalintegerTotal de registros

Cada item de pagamentos inclui, entre outros: id, endToEndId, chave, valor, txid, status, tipo, id_req, recebedor, pagador, dataHoraCriacao, dataHoraAtualizacao, tipo_transacao, rec_status. Em erro: erro_codigo, erro_descricao.

statusSignificado
"0"INICIADO
"9"CONFIRMADO
"-1"ERRO

Na listagem, recebedor e pagador podem vir como arrays vazios ([]). tipo_transacao -1 = débito; 1 = crédito (espelho).

Códigos de resposta

CódigoSignificadoDescrição
200OKLista retornada com sucesso.
401UnauthorizedToken inválido ou expirado.
403ForbiddenScope pix.read ausente.
500ErrorErro interno do servidor.

Notas

curl --location 'https://api-h.nuvende.com.br/api/v2/pix/pagamentos' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}'

{
  "pagamentos": [
    {
      "id": "38cdf7dc-1af9-4536-be5c-4f3263eee3c9",
      "endToEndId": "E38297374202606291452SRRBZF9DR3X",
      "chave": "51e09faa-ca26-4c24-81f5-7518197648d4",
      "valor": 2.22,
      "txid": "15lmIhGUAZoXfPn3pNBLCEzc9e",
      "erro_codigo": "000",
      "erro_descricao": "Ocorreu um erro inesperado ao efetuar transferencia.",
      "status": "-1",
      "tipo": 3,
      "id_req": null,
      "recebedor": [],
      "pagador": [],
      "dataHoraAtualizacao": "2026-06-29T18:15:06.000000Z",
      "dataHoraCriacao": "2026-06-29T14:52:46.000000Z",
      "tipo_transacao": -1,
      "rec_status": null
    },
    {
      "id": "ce8cd106-b413-45d3-9835-6cc701176088",
      "endToEndId": "E3829737420260629145447088689815",
      "chave": "51e09faa-ca26-4c24-81f5-7518197648d4",
      "valor": 2.22,
      "txid": "15lmIhGUAZoXfPn3pNBLCEzc9e",
      "status": "9",
      "tipo": 3,
      "id_req": "71de3c09-8be0-48b2-883a-d6b0a31ce0ae",
      "recebedor": [],
      "pagador": [],
      "dataHoraAtualizacao": "2026-06-29T14:54:47.000000Z",
      "dataHoraCriacao": "2026-06-29T14:54:45.000000Z",
      "tipo_transacao": -1,
      "rec_status": null
    }
  ],
  "correlationId": "ca387ccd-4904-4eb0-8b5e-c304776b6592",
  "currentPage": 1,
  "lastPage": 6,
  "perPage": 10,
  "from": 1,
  "to": 10,
  "total": 55
}

const axios = require("axios");

axios
  .get("https://api-h.nuvende.com.br/api/v2/pix/pagamentos", {
    headers: {
      Accept: "application/json",
      Authorization: "Bearer {{access_token}}",
    },
  })
  .then((response) => console.log(JSON.stringify(response.data)))
  .catch((error) => console.log(error.response?.data || error.message));

import requests

url = "https://api-h.nuvende.com.br/api/v2/pix/pagamentos"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
}
response = requests.get(url, headers=headers)
print(response.text)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/pix/pagamentos',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'Authorization: Bearer {{access_token}}',
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;