Sivutus

Suuret kokoelmat (maksuaikomukset, laskut, transaktiot, webhook-toimitukset, tapahtumat) sivutetaan kursorilla. Listat järjestetään uusimmasta alkaen.

Parametri	Oletus	Kuvaus
limit	25	Sivun koko, 1–100
starting_after	—	Edellisen sivun viimeisen objektin id

{
  "object": "list",
  "data": [{ "id": "pi_01J…", "object": "payment_intent" }],
  "has_more": true,
  "next_cursor": "pi_01J…"
}

Hae seuraava sivu antamalla next_cursor parametrin starting_after arvoksi. Kun has_more on false, next_cursor on null. Kursorit pysyvät vakaina, vaikka uusia objekteja luotaisiin samaan aikaan.

Pienet kokoelmat (kaupat, lompakot, webhook-päätepisteet, maksulinkit) palauttavat muodon { "object": "list", "data": [...] } ilman sivutusta.

Automaattinen sivutus

TypeScript

// Awaiting returns one page; iterating walks every page lazily.
const firstPage = await gp.paymentIntents.list({ limit: 50 });

for await (const intent of gp.paymentIntents.list({ status: ['confirmed', 'overpaid'] })) {
  console.log(intent.id);
}

Go

for intent, err := range client.PaymentIntents.All(ctx, &feitpay.PaymentIntentListParams{Limit: 100}) {
  if err != nil {
    return err
  }
  fmt.Println(intent.ID)
}

Python

for intent in gp.payment_intents.list_all(limit=100):
    print(intent["id"])

Suodattaminen

GET /v1/payment-intents hyväksyy myös parametrit status (pilkuilla eroteltuina), store_id, search (osuu tunnisteeseen, merchant_order_id-arvoon, asiakkaan sähköpostiin tai viitteeseen ja kuvaukseen), created_gte, created_lt ja source. Suodattimia voi käyttää yhdessä sivutuksen kanssa.