Remboursements

Rendre tout ou partie d'un encaissement.

Créer un remboursement

POST /v1/refunds

Champ	Requis	Description
payment_id	oui	L'encaissement d'origine : son identifiant ou sa référence
amount_minor	—	Chaîne, en unités mineures. Absent = le solde restant
reason	—	customer_request, duplicate, fraudulent ou other
description	—	Texte libre, visible dans le tableau de bord

Le remboursement est une opération à part entière : son propre id, son propre statut, son propre événement webhook (refund.success / refund.failed).

Règles

• Seul un encaissement réussi se rembourse.
• Le cumul des remboursements ne peut pas dépasser le montant encaissé — l'API répond 422 invalid_request au-delà.
• Les frais d'encaissement ne sont pas rendus : ils restent à votre charge.
• Un remboursement partiel laisse l'encaissement d'origine consultable, avec son historique complet.
• Les fonds sont prélevés sur votre solde disponible au moment de l'appel, comme un versement.

Une clé d'idempotence par remboursement. Jamais l'identifiant du paiement d'origine : un encaissement peut être remboursé en plusieurs fois, et une clé portant l'identifiant du parent ferait passer le second remboursement partiel pour un rejeu du premier.

Lire et lister

GET /v1/refunds/{id}
GET /v1/refunds