Litiges

Lister les litiges

GET/v1/disputespayments:read

Requires payments:read. Views: to_handle (needs_response, warning_needs_response), in_review (under_review, warning_under_review), closed (every other status). Disputes come from the provider's signed notifications on the connection (charge.dispute.*); a dispute on a payment PayHaze did not create is ignored.

En-têtes

AuthorizationBearer pos_key_…obligatoire: Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire: L’espace marchand concerné (mrc_…).

Paramètres

viewdans la requête
qdans la requête: Case-insensitive substring of the payment's merchant_reference; % and _ are literal.
fromdans la requête: Opened at or after (RFC 3339).
todans la requête: Opened strictly before (RFC 3339); must follow from.
statedans la requête
mindans la requête: Minimum contested amount in EUR, inclusive.
maxdans la requête: Maximum contested amount in EUR, inclusive; not below min.
paymentdans la requête: Only the disputes of this payment id.
limitdans la requête
offsetdans la requête

Réponses

200Réussi
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.