Documentation/Lister les litiges
openapi.jsonOuvrir mon espace

Lister les litiges

GET/v1/disputes

Les litiges de votre espace, du plus récent au plus ancien.

Le dossier se dépose dans votre espace, pièces à l’appui : l’API le lit, elle ne le remplit pas.

Ce qu’on met dans l’adresse

status« needs_response » · « evidence_submitted » · « under_review » · « won » · « lost »Ne rendre que les litiges dans cet état.
paymenttexteLe litige d’un paiement.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

La demande

bash
curl https://api.payiz.app/v1/disputes \
  -H "Authorization: Bearer sk_test_…"

La réponse

json
{
  "object": "list",
  "url": "/v1/disputes",
  "has_more": false,
  "data": [
    {
      "object": "dispute",
      "id": "dp_01j9xh2qr5n8vwd3ke7m",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "needs_response",
      "reason": "Article non reçu",
      "evidence_due_by": 1790614692,
      "evidence_submitted_at": null,
      "closed_at": null,
      "created": 1790009892,
      "livemode": false
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets dispute

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets disputeLes litiges de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.

© 2026 PayizUne question ? L’aide est dans le rond, en bas à droite.

Lister les litiges

GET/v1/disputes

Les litiges de votre espace, du plus récent au plus ancien.

Le dossier se dépose dans votre espace, pièces à l’appui : l’API le lit, elle ne le remplit pas.

Ce qu’on met dans l’adresse

status« needs_response » · « evidence_submitted » · « under_review » · « won » · « lost »Ne rendre que les litiges dans cet état.
paymenttexteLe litige d’un paiement.
limitentierDe 1 à 100. Par défaut 20.
starting_aftertexteL’identifiant de la dernière ligne lue : la page suivante commence après.

La demande

bash
curl https://api.payiz.app/v1/disputes \
  -H "Authorization: Bearer sk_test_…"

La réponse

json
{
  "object": "list",
  "url": "/v1/disputes",
  "has_more": false,
  "data": [
    {
      "object": "dispute",
      "id": "dp_01j9xh2qr5n8vwd3ke7m",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "needs_response",
      "reason": "Article non reçu",
      "evidence_due_by": 1790614692,
      "evidence_submitted_at": null,
      "closed_at": null,
      "created": 1790009892,
      "livemode": false
    }
  ]
}

Ce qu’on reçoit

200 · une liste d’objets dispute

object« list »Le genre de l’objet rendu : il ne change jamais.
dataliste d’objets disputeLes litiges de la page, du plus récent au plus ancien.
has_morevrai ou fauxVrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue.
urltexteL’adresse qui a servi, sans les filtres.

Enchaîner les pages

Tant que has_more est vrai, rappelez avec starting_after réglé sur l’identifiant de la dernière ligne lue. Les listes vont du plus récent au plus ancien.