Remboursements
Créer un remboursement
POST/v1/refundsrefunds:write
Requires refunds:write. Cookie mutations require CSRF. Local and test mode only.
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.
Idempotency-Keystringobligatoire
Corps
payment_idstringobligatoireamountstringobligatoirereason"returned_item" | "goodwill" | "amount_error" | "other"- Optional. For the merchant team only, never sent to the provider nor part of idempotency; a replay keeps the first reason.
Réponses
- 202Demande enregistrée
- 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.