PayHazeDocsTableau de bord

Remboursements

Lister les remboursements

GET/v1/refundspayments:read

Requires payments:read. One page of the chosen view (newest first), its total, and the count and sum of every view under the same filters. pending: PLANNED, REQUIRES_ACTION or PROCESSING; uncertain: INDETERMINATE; failed: FAILED_CONFIRMED; succeeded: SUCCEEDED. Unknown or out-of-range parameters are rejected with 400.

En-têtes

AuthorizationBearer pos_test_…obligatoire
Clé de serveur. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).
X-Environment"test"obligatoire
Seule valeur acceptée tant que la production n’est pas ouverte.

Paramètres

viewdans la requête
qdans la requête
Case-insensitive substring of the payment's merchant_reference, or the refund id; % and _ are literal.
fromdans la requête
Created at or after (RFC 3339).
todans la requête
Created strictly before (RFC 3339); must follow from.
statedans la requête
origindans la requête
mindans la requête
Minimum original amount in EUR, inclusive.
maxdans la requête
Maximum original amount in EUR, inclusive; not below min.
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.