Ambiente de simulação — nenhuma cobrança real. Os pagamentos, Pix e cartões deste sandbox são sintéticos.
W Wolf Sandbox Docs Criar conta
Navegação

Paginação

As listagens de produtos, ofertas e pedidos são paginadas por cursor. O cursor é opaco: repita os mesmos filtros e passe o next_cursor recebido.

Listagens com cursor

  • Com qualquer parâmetro de consulta a resposta é {"data": [...], "next_cursor": "..."}. next_cursor: null indica a última página.
  • limit vai de 1 a 100 (padrão 50). q busca por texto (1 a 120 caracteres) e status filtra por estado.
  • Sem nenhum parâmetro a resposta é a lista completa legada ({"data": [...]}, sem next_cursor). Integrações novas devem sempre enviar limit.
  • Parâmetro desconhecido ou cursor inválido responde 400 VALIDATION_FAILED.

Parâmetros de GET /v1/orders

NomeOndeTipoDetalhes
q consulta string

1 a 120 caracteres

status consulta string | "pending_payment"
min_amount consulta string

Padrão ^[1-9][0-9]*$

product_id consulta string

Padrão ^prd_[A-Za-z0-9]+$

até 128 caracteres

offer_id consulta string

Padrão ^off_[A-Za-z0-9]+$

até 128 caracteres

method consulta string

Valores: card, pix

from consulta string

Padrão ^\d{4}-\d{2}-\d{2}$

to consulta string

Padrão ^\d{4}-\d{2}-\d{2}$

limit consulta integer

de 1 a 100

Padrão: 50

cursor consulta string

Padrão ^o1_[0-9a-f]+$

até 2048 caracteres

Node.js — percorrer todas as páginas Node.js
// Percorre todos os pedidos pagos, 100 por página.
async function* paidOrders({ apiUrl = process.env.WOLF_API_URL, apiKey = process.env.WOLF_API_KEY } = {}) {
  let cursor = null;
  do {
    const query = new URLSearchParams({ status: 'paid', limit: '100', ...(cursor ? { cursor } : {}) });
    const response = await fetch(`${apiUrl}/v1/orders?${query}`, { headers: { Authorization: `Bearer ${apiKey}` } });
    const page = await response.json();
    if (!response.ok) throw new Error(`Wolf API ${response.status}: ${page.error?.code}`);
    yield* page.data;
    cursor = page.next_cursor; // null na última página
  } while (cursor);
}

GET /v1/payment-links devolve os links mais recentes primeiro, até limit (1 a 100, padrão 50), com filtros offer_id e status; não há cursor.

Outras listagens

Endpoints e entregas de webhook, API keys, repasses, liquidações e disputas devolvem {"data": [...]} com os itens do seller, sem paginação.