Remboursements

Page générée depuis la spécification OpenAPI que la passerelle sert (GET /v1/openapi.json). Ne la modifiez pas à la main : elle est réécrite à chaque build.

Méthode	Chemin	Description
GET	/v1/refunds	Lister les remboursements
POST	/v1/refunds	Rembourser
GET	/v1/refunds/{id}	Consulter un remboursement

GET /v1/refunds

Lister les remboursements

Même pagination que les encaissements.

Paramètres

Nom	Emplacement	Requis	Description
page	query	non	Page, à partir de 1.
per_page	query	non	Taille de page, 100 au maximum.

Réponses

• 200 — OK
• 401 — Clé API manquante ou rejetée
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After

POST /v1/refunds

Rembourser

Remboursement total ou partiel d'un encaissement réussi ; les fonds sont prélevés sur le solde disponible au moment de l'appel. Omettre amount_minor rembourse le solde restant.

⚠️ L'en-tête Idempotency-Key doit être propre à CE remboursement, jamais l'identifiant du paiement d'origine : un paiement 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 — succès côté marchand, client non remboursé.

Paramètres

Nom	Emplacement	Requis	Description
Idempotency-Key	header	non	Clé d'idempotence propre à CETTE opération. Rejouer la même clé avec la même charge utile retourne l'originale ; la rejouer avec une charge utile différente est refusé (409).

Réponses

• 201 — Remboursement créé
• 401 — Clé API manquante ou rejetée
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif
• 409 — Clé d'idempotence rejouée avec une charge utile différente
• 422 — Requête recevable mais refusée : champ manquant, corridor fermé, solde insuffisant
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After

GET /v1/refunds/{id}

Consulter un remboursement

La même vue masquée que GET /v1/payments/{id}.

Paramètres

Nom	Emplacement	Requis	Description
id	path	oui	Identifiant interne, référence de l'opération, ou votre propre client_ref.

Réponses

• 200 — OK
• 401 — Clé API manquante ou rejetée
• 403 — La clé ne porte pas le scope requis, ou le compte n'est pas actif
• 429 — Budget de requêtes de la clé épuisé (300/min) — honorer Retry-After