Lister les transactions

Paramètres de requête

• customerchaîne· requêtefacultatif

  N'obtenir que les paiements de ce client — <uuid> ou cus_<uuid>.

  Un identifiant inconnu, ou d'un autre marchand, rend une collection vide et non 404 : c'est un critère de recherche, pas une ressource adressée, et l'URL désigne bien la collection des transactions, qui existe. Un identifiant malformé, lui, vaut 400.

• limitentier· requêtefacultatif
  minimum 1maximum 100défaut 25

  Nombre d'éléments par page, entre 1 et 100. Vaut 25 par défaut sur toutes les collections.

  Une valeur hors bornes est refusée par un 400 validation_error, jamais rabattue en silence sur 100.

• starting_afterchaîne· requêtefacultatif
  exemple 8f14e45f-ceea-4c1a-9b7d-2a3f6c8e01b4

  Curseur. Ne rend que les éléments situés APRÈS celui-ci dans l'ordre de parcours, donc plus anciens. L'élément désigné n'est jamais inclus dans la page.

  C'est le paramètre du parcours normal : lisez une page, reprenez avec l'identifiant de son dernier élément.

  Ne se combine ni avec ending_before, ni avec offset.

• ending_beforechaîne· requêtefacultatif
  exemple 8f14e45f-ceea-4c1a-9b7d-2a3f6c8e01b4

  Curseur inverse. Ne rend que les éléments situés AVANT celui-ci dans l'ordre de parcours, donc plus récents. L'élément désigné n'est jamais inclus dans la page.

  Sous ce paramètre, has_more parle de ce qui reste avant la page, pas après.

  Ne se combine ni avec starting_after, ni avec offset.

• offsetentier· requêtefacultatif
  minimum 0défaut 0

  Déprécié, remplacé par starting_after. Reste accepté au minimum douze mois, avec exactement le comportement qu'il a toujours eu.

  Pourquoi il est déprécié : un décalage nomme une POSITION dans un classement qui bouge. Dès qu'une ligne naît pendant votre parcours, tout ce qui suit glisse d'un cran, et vous sautez un élément sans rien voir. Un curseur nomme une LIGNE, et ne glisse pas.

  Il n'est pas traduit en curseur : un décalage n'a pas d'équivalent en curseur, et prétendre le contraire vous rendrait une position instable rebaptisée.

  Ne se combine ni avec starting_after, ni avec ending_before.

• expand[]liste· requêtefacultatif

  Développe une référence : le champ porte l'objet complet au lieu de son seul identifiant, qui reste servi. Répétez le paramètre pour plusieurs chemins.

  Chemins acceptés : payment_method → customer ; payment_link → price ; price → product ; setup_intent → customer, payment_method ; transaction → payment_method ; transaction → payment_link, customer ; refund → transaction, transaction.payment_link, transaction.customer ; webhook_delivery → event. Un chemin inconnu vaut 400, en énumérant les chemins acceptés.

  Profondeur maximale : 2. Au delà, 400 : un expand sans borne est une attaque par amplification.

• statuschaîne· requêtefacultatif
  valeurs : pending, processing, succeeded, failed, refunded
• created_afterchaîne· requêtefacultatif
  format date-time