Paginación

Lee una página o recorre una colección con un iterador asíncrono.

Una página

const page = await billete.payments.list({
  limit: 50,
  status: "succeeded",
});

La respuesta incluye data y nextCursor. Consulta otra página solo si existe cursor:

if (page.nextCursor) {
  const nextPage = await billete.payments.list({
    limit: 50,
    status: "succeeded",
    cursor: page.nextCursor,
  });
}

Toda la colección

for await (const payment of billete.payments.iterate({
  status: "succeeded",
  createdFrom: "2026-10-01T00:00:00Z",
  createdTo: "2026-10-31T23:59:59.999Z",
})) {
  // Process each payment without logging customer data.
}

iterate solicita páginas a medida que las necesitas. Usa break cuando tengas lo necesario.

Los rangos son inclusivos. Conserva los filtros al avanzar por cursor y recuerda que los límites de fecha del ejemplo están expresados en UTC.