Rembourser

Rembourse tout ou partie d'un paiement réussi.

curl -X POST "$VALSORIA_BASE/v1-refunds" \
  -H "Authorization: Bearer $VALSORIA_CLE" \
  -H "Idempotency-Key: rbt-cmd-2026-00412" \
  -H "Content-Type: application/json" \
  -d '{ "payment_id": "txn_6INMt2lIL1Pv_y6RgqZvag", "amount": 5000 }'

Sans amount, le reste remboursable est rendu en totalité. Le paiement passe alors en partially_refunded ou refunded selon ce qui reste.

Tous les canaux ne savent pas rembourser

Un paiement encaissé par un canal sans opération inverse est refusé en 422 refund_unsupported, avant toute écriture — pas de remboursement créé, pas de clé d'idempotence consommée.

Le refus est immédiat plutôt que différé, et c'est important pour vous : mieux vaut ne rien promettre à votre client que lui promettre un remboursement qui n'aura pas lieu. Renvoyer l'argent reste possible, mais c'est alors un décaissement, à demander comme tel.

Ce que vous ne pouvez pas faire

• Rembourser un paiement qui n'est pas succeeded — 409.
• Rembourser au-delà du reste remboursable — 422 amount_too_large.
• Rembourser deux fois avec la même clé — le rejeu rend le premier remboursement, sans en créer un second.

Côté comptable

Un remboursement n'efface rien. Il ajoute une écriture inverse : l'historique reste complet, et votre solde en attente diminue du montant remboursé. Aucune écriture n'est jamais modifiée ni supprimée, chez nous.

Version d'API 2026-08-25 · changements · spécification OpenAPI