Rembourser ou annuler un paiement

Rembourse tout ou partie d'un paiement capturé (crédit réel vers la carte), ou annule (void) une autorisation non encore capturée (aucun débit n'a eu lieu). L'opération est déterminée automatiquement par l'état du paiement. amountCents est optionnel, exprimé dans la devise d'origine du paiement : absent = remboursement/annulation de ce qui reste.

Plusieurs remboursements partiels : un paiement se rembourse en une ou plusieurs fois (un article, puis un autre), jusqu'au montant payé. Un paiement capturé en partie se rembourse jusqu'au montant capturé, jamais au-delà. Chaque réponse indique le cumul remboursé (totalRefundedAmount) et ce qui reste (remainingAmount), dans la devise d'origine ; GET /api/v1/payments/{id} les donne aussi (refundedAmount, refundableAmount). Le remboursement qui solde le paiement le fait passer refunded, même s'il est lui-même partiel.

Mobupay émet le webhook correspondant : payment.partially_refunded tant qu'il reste un montant, payment.refunded au solde, payment.cancelled pour une annulation. Pour les modes de financement plateforme (marchand absorbe / plateforme absorbe / split) et le cas net carte = 0, voir la section Cas d'usage (/docs/usecases/distant/plateforme/cas-particuliers).

Commission d'un logiciel connecté : on ne rembourse jamais avec l'argent d'un tiers. Sur un paiement émis par un logiciel qui y prélève sa commission, cette commission reste acquise au logiciel : le marchand qui rembourse (depuis son espace ou avec ses propres clés) le fait à ses frais, et rien ne lui en est rendu. Seul le logiciel qui a émis le paiement, en remboursant avec la clé qu'il détient pour le marchand, peut choisir d'en rendre une part par integratorCommissionRefund : prorata (au prorata du montant remboursé), full (tout ce qui reste), none (rien), rate (une part, en centièmes de pour-cent : 5000 = 50 %) ou amount (un montant, dans la devise d'origine comme amountCents). Tout autre appelant ne peut envoyer que none (403 INTEGRATOR_COMMISSION_REFUND_NOT_ALLOWED sinon). Sans ce champ, rien n'est rendu. Les frais Mobupay ne sont jamais rendus, et la commission de plateforme garde sa règle. Le cumul des remboursements d'un paiement ne rend jamais plus que la commission propre à ce paiement : un choix qui dépasse ce qui reste est refusé (400 INTEGRATOR_COMMISSION_REFUND_EXCEEDS, le détail donnant remainingFraction et remainingAmount), les remboursements dont l'avis bancaire n'est pas encore arrivé comptant déjà. Sans ce champ, le remboursement n'est jamais refusé pour la commission. Sur un paiement qui porte une commission de logiciel, la réponse porte integratorCommissionRefund : mode, fraction (la part de la commission que CE remboursement rend), expectedRefundCents (centimes d'euro) et expectedRefundAmount (devise d'origine), status: "pending". Le rendu passe à l'avis bancaire du remboursement : le montant de la réponse est prévu, le logiciel reçoit le réel par integrator.commission.restituted. Un logiciel ne rembourse jamais avec sa clé sk_int_* (403 INTEGRATOR_KEY_OWN_ROUTES_ONLY) : il rembourse au nom de son client, avec la clé qu'il détient pour lui.