Aller au contenu

Remboursements

Remboursez un paiement Cardencer capturé, en totalité ou en partie, depuis l'API ou le dashboard, et suivez le statut du remboursement.

Un remboursement restitue des fonds déjà capturés. Si un paiement est encore autorisé et en attente de capture, annulez-le plutôt que de le rembourser, ou capturez-le d'abord.

Vous pouvez effectuer un remboursement depuis Refunds sur le dashboard, ou via l'API.

Créez un remboursement#

Appelez POST /refunds avec le payment_id. Omettez amount pour rembourser la totalité du montant encore remboursable ; indiquez-le pour un remboursement partiel.

curl https://sandbox.cardencer.com/refunds \
  -H "api-key: $CARDENCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_id": "pay_mbabizu24mvu3mela5njyhpit4",
    "amount": 500,
    "reason": "Customer returned the item",
    "metadata": { "order_reference": "58211" }
  }'
Champ Obligatoire Description
payment_id Oui Le paiement à rembourser.
amount Non Montant dans la plus petite unité de la devise. Omettez-le pour un remboursement total.
refund_id Non Votre propre identifiant unique pour ce remboursement. Cardencer en génère un s'il est omis. La réutilisation d'un identifiant est refusée, ce qui vous protège des doubles remboursements lors des nouvelles tentatives.
reason Non Texte libre, enregistré avec le remboursement.
metadata Non Vos propres données clé/valeur.

La réponse contient refund_id, payment_id, amount, currency, status, reason et metadata.

Montant remboursable#

remboursable = amount_captured − somme des remboursements précédents non échoués
  • Vous pouvez effectuer plusieurs remboursements partiels jusqu'à épuisement du montant capturé.
  • La limite correspond au montant capturé, et non au montant autorisé : après une capture partielle, seule la partie capturée est remboursable.
  • Un paiement est remboursable lorsque son statut est succeeded ou partially_captured.
  • Les remboursements échoués ne sont pas déduits du montant remboursable.
  • Demandez les remboursements dans un délai de 365 jours à compter de la date de création du paiement.

Statuts de remboursement#

Statut Signification
pending Envoyé, en attente du résultat final de l'acquéreur.
succeeded Le remboursement a abouti.
failed Le remboursement n'a pas abouti. Vous pouvez réessayer.
review Le remboursement nécessite une vérification manuelle. Le support Cardencer reviendra vers vous.

La réponse à la création peut déjà indiquer succeeded ; sinon, elle indique pending. Suivez le remboursement avec les webhooks refund_succeeded et refund_failed, ou récupérez-le :

curl https://sandbox.cardencer.com/refunds/ref_mbabizu24mvu3mela5njyhpit4 \
  -H "api-key: $CARDENCER_API_KEY"

Quand le client voit-il les fonds ?#

Un remboursement succeeded a quitté Cardencer. Il apparaît généralement sur le relevé du client sous 5 à 10 jours ouvrés, selon sa banque.

Listez les remboursements#

curl https://sandbox.cardencer.com/refunds/list \
  -H "api-key: $CARDENCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payment_id": "pay_mbabizu24mvu3mela5njyhpit4" }'

Consultez la référence de l'API Refunds pour le détail de chaque champ.