Remboursements

Remboursez une transaction capturée totalement ou partiellement. Les remboursements sont traités sur la carte d'origine et émettent un webhook payment.refunded.

Émettre un remboursement

POST /api/v1/payments/{transaction_id}/refund

{
  "amount": 1000,
  "reason": "Customer request"
}

Réponse

{
  "id": "ref_xyz789",
  "payment_id": "txn_789xyz",
  "amount": 1000,
  "status": "completed",
  "created_at": "2026-05-05T12:00:00+00:00"
}

Remboursements partiels et multiples

• Renseignez amount inférieur au montant original pour un remboursement partiel.
• Plusieurs remboursements partiels sont autorisés jusqu'à concurrence du montant capturé.
• Chaque remboursement déclenche son propre webhook payment.refunded.

Refund vs void

Si la transaction sous-jacente est autorisée mais pas encore capturée, utilisez plutôt Void — cela libère la réservation sans créer de remboursement. Une fois capturée, seul refund s'applique.

Codes de raison

reason est un texte libre, stocké sur l'enregistrement du remboursement et visible sur les reçus et le tableau de bord. Gardez-le adapté au client — il apparaît dans la documentation des litiges.

Suite

• Captures et annulations — pour les transactions en mode authorize
• Webhooks — écoutez payment.refunded