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" }
}'const refund = await fetch("https://sandbox.cardencer.com/refunds", {
method: "POST",
headers: { "api-key": process.env.CARDENCER_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
payment_id: "pay_mbabizu24mvu3mela5njyhpit4",
amount: 500,
reason: "Customer returned the item",
metadata: { order_reference: "58211" },
}),
}).then((r) => r.json());
console.log(refund.refund_id, refund.status);refund = requests.post(
"https://sandbox.cardencer.com/refunds",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json={
"payment_id": "pay_mbabizu24mvu3mela5njyhpit4",
"amount": 500,
"reason": "Customer returned the item",
"metadata": {"order_reference": "58211"},
},
).json()
print(refund["refund_id"], refund["status"])| 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
succeededoupartially_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"const refund = await fetch(`https://sandbox.cardencer.com/refunds/${refundId}`, {
headers: { "api-key": process.env.CARDENCER_API_KEY },
}).then((r) => r.json());refund = requests.get(
f"https://sandbox.cardencer.com/refunds/{refund_id}",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
).json()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.