Litiges

Page générée depuis la spécification OpenAPI que la passerelle sert (GET /v1/openapi.json). Ne la modifiez pas à la main : elle est réécrite à chaque build.

Méthode	Chemin	Description
GET	/v1/disputes	Lister les litiges
GET	/v1/disputes/{id}	Consulter un litige
POST	/v1/disputes/{id}/response	Répondre à un litige

GET /v1/disputes

Lister les litiges

Les contestations ouvertes contre vos encaissements, avec leur échéance de réponse.

Paramètres

Nom	Emplacement	Requis	Description
page	query	non
per_page	query	non
status	query	non

Réponses

• 200 — OK
• 401 — Clé API manquante ou rejetée (Error)
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif (Error)
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After (Error)

GET /v1/disputes/{id}

Consulter un litige

Le litige, son motif et son état.

Paramètres

Nom	Emplacement	Requis	Description
id	path	oui	L'identifiant ou la référence du litige.

Réponses

• 200 — OK
• 401 — Clé API manquante ou rejetée (Error)
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif (Error)
• 404 — Aucun litige de cet identifiant (Error)
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After (Error)

POST /v1/disputes/{id}/response

Répondre à un litige

Votre défense : un texte et les pièces qui l'appuient.

⚠️ CE TEXTE NE PASSE NI PAR LE FLUX D'ÉVÉNEMENTS NI PAR LE MODÈLE DE LECTURE ([DB-13]) — il n'est donc jamais rendu par les lectures ci-dessus. La réponse de cet appel est l'instantané autoritatif, et c'est le seul endroit où vous le reverrez.

Un litige déjà avancé au-delà de open, ou dont la fenêtre de réponse est close, refuse en 422 : aucune reprise ne le fera passer.

Paramètres

Nom	Emplacement	Requis	Description
id	path	oui	L'identifiant ou la référence du litige.
Idempotency-Key	header	non	Clé d'idempotence propre à CETTE opération.

Corps de la requête

Champ	Type	Requis	Description
merchant_response	string	non	Votre argumentaire.
evidence	string[]	non	Les pièces jointes, par leur référence de document.

Réponses

• 200 — Réponse enregistrée
• 401 — Clé API manquante ou rejetée (Error)
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif (Error)
• 404 — Aucun litige de cet identifiant (Error)
• 422 — Le litige ne peut plus recevoir de réponse (Error)
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After (Error)
• 503 — L'échelle de l'actif est momentanément illisible — le montant serait faux, il n'est donc pas rendu (Error)

Schémas

Les formes renvoyées par les opérations ci-dessus.

Error

Champ	Type	Description
error	object
error.code	string
error.message	string