WysePayDocs

Paginação

Como percorrer listas de transações, links, clientes e saques.

As listas vêm da mais nova para a mais antiga, em páginas:

{
  "data": [ { "id": "txn_01k6…", "…": "…" }, { "id": "txn_01k5…", "…": "…" } ],
  "hasMore": true
}
  • limit: quantos itens por página, de 1 a 100 (padrão 20).
  • startingAfter: o id do último item que você recebeu. A próxima página começa depois dele.
  • hasMore: true quando há mais páginas.
# Primeira página
curl "https://api.wysepay.com.br/api/v1/transactions?limit=50" \
  -H "x-api-key: wyp_test_sua_chave"

# Próxima: startingAfter = o id do último item da página anterior
curl "https://api.wysepay.com.br/api/v1/transactions?limit=50&startingAfter=txn_01k5…" \
  -H "x-api-key: wyp_test_sua_chave"

Diferente de "página 2, página 3", o cursor não pula nem repete itens quando chegam pagamentos novos enquanto você percorre a lista.

Filtros

ListaFiltros
Transaçõesstatus, paymentLinkId, createdFrom, createdTo
Linksactive (true ou false)
Clientesdocument (CPF ou CNPJ)
Saques—

O filtro status=EXPIRED inclui os Pix que venceram sem pagamento, do mesmo jeito que a consulta de uma transação mostra.

Nesta página