Remboursements
Créer un remboursement
POST/v1/refundsrefunds:write
Autorisation refunds:write. Rembourse un paiement réussi, en entier ou en partie, jamais au-delà de ce qui reste. Le résultat arrive par refund.updated. 409 payment_disputed pendant un litige ouvert : l’argent est déjà retenu par la banque de l’acheteur.
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_…).
Idempotency-Keystringobligatoire- La même clé avec la même demande retrouve la première réponse ; avec une autre demande : 409.
Corps
payment_idstringobligatoireamountstringobligatoire- Le montant en texte, avec ses décimales (124.90). Les limites de chaque devise : GET /v1/currencies.
reason"returned_item" | "goodwill" | "amount_error" | "other"- Pour votre équipe seulement, jamais envoyé au prestataire.
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.