DocsTableau de bord

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_idstringobligatoire
amountstringobligatoire
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.