Remboursement et annulation des paiements

Découvrez comment annuler ou rembourser un paiement.

Vous pouvez annuler un paiement sans frais avant qu’il ne soit finalisé, ou rembourser une partie ou l’intégralité d’un paiement après qu’il a réussi, ce qui peut entraîner des frais. Pour en savoir plus, consultez notre page tarifaire.

Les remboursements sont prélevés dans votre solde Stripe disponible (sans les montants en attente). Si votre solde disponible ne couvre pas le montant du remboursement, Stripe maintiendra le remboursement en attente jusqu’à ce que votre solde Stripe devienne suffisant. Vous pouvez remédier à un solde Stripe négatif en collectant des paiements ou en rechargeant le solde de votre compte. Dans les territoires où cela est applicable, Stripe peut débiter automatiquement vos comptes bancaires pour récupérer un solde Stripe négatif.

Demandes de remboursement

Nous soumettons les demandes de remboursement à l’institution financière de votre client ou à l’émetteur de carte . Les remboursements réussis s’affichent sur le relevé bancaire de vos clients en temps réel, en fonction du réseau de cartes et de l’institution financière émettrice. Les litiges et les contestations de paiement ne sont pas possibles sur les frais de carte de crédit entièrement remboursés.

Si l’ensemble des conditions suivantes sont réunies, nous envoyons un courriel à votre client pour l’informer de ce remboursement :

Le paiement initial a été créé pour un client dans votre compte Stripe.
Le client dispose d’une adresse courriel enregistrée.
Vous avez activé Envoyer un courriel aux clients pour obtenir des remboursements dans le Dashboard.

Vous pouvez afficher les paiements remboursés dans le Dashboard

Effectuer des remboursements

Vous pouvez émettre des remboursements à l’aide de l’API Refunds ou du Dashboard. Vous pouvez émettre plusieurs remboursements pour un paiement, mais le montant total du remboursement ne peut être supérieur au montant du paiement initial.

Pour rembourser un paiement à l’aide de l’API, créez un remboursement en fournissant l’ID du paiement ou le PaymentIntent.

Lorsque vous utilisez un PaymentIntent pour encaisser un paiement, Stripe crée un objet charge. Pour rembourser un paiement après la réussite du PaymentIntent, créez un remboursement à l’aide du PaymentIntent, de façon à rembourser le paiement sous-jacent. Vous pouvez également ne rembourser qu’une partie d’un paiement en spécifiant un montant. Si vous utilisez les API Stripe Tax pour consigner vos ventes, vous devez consigner les remboursements.

Pour effectuer un remboursement partiel d’un PaymentIntent, saisissez un paramètre amount qui devra être un nombre entier exprimé en cents (ou dans la plus petite unité de la devise du paiement).

Si vous souhaitez séparer l’autorisation de la capture d’un paiement, et rembourser un PaymentIntent dont l’état est requires_capture, le processus de remboursement est différent. Dans ce cas, le paiement associé au PaymentIntent n’est toujours pas capturé et ne peut être remboursé directement. Vous devez annuler le PaymentIntent.

Remboursements par le biais d’une plateforme Connect

Le comportement de remboursement dépend du type de paiement Connect utilisé dans votre intégration.

Stripe débite directement le compte connecté pour les remboursements sur des paiements directs.
Stripe débite votre plateforme pour les remboursements sur des paiements indirects ou des paiements et transferts distincts (avec ou sans on_behalf_of). Annulez les transferts associés à ces types de paiement pour récupérer le montant du remboursement auprès de vos comptes connectés.

Destinations des remboursements

Les remboursements ne peuvent être émis que sur le moyen de paiement d’origine. Vous ne pouvez pas émettre un remboursement vers une autre destination, comme une autre carte ou un autre compte bancaire.

Les remboursements effectués vers des cartes expirées ou annulées sont gérés par l’émetteur de la carte du client. Dans la plupart des cas, ils sont crédités sur la nouvelle carte du client. Si aucune nouvelle carte n’existe, l’émetteur de la carte effectue généralement le remboursement au moyen d’une autre méthode (chèque ou virement bancaire). Dans de rares cas, un remboursement sur une carte peut échouer.

Pour les autres moyens de paiement, comme (ACH et iDEAL, la gestion des remboursements varie d’une institution financière à l’autre. Si le client a résilié son moyen de paiement, l’institution financière peut nous renvoyer le remboursement, qui est alors marqué comme ayant échoué.

Traiter les échecs de remboursement

Un remboursement peut échouer si l’institution bancaire ou l’émetteur de la carte du client ne peut le traiter. Par exemple, un compte bancaire fermé ou un problème lié à la carte peut entraîner l’échec d’un remboursement. Lorsque cela se produit, l’institution bancaire nous renvoie le montant remboursé et nous l’ajoutons à votre solde de compte Stripe. Ce processus peut prendre jusqu’à 30 jours à compter de l’émission du remboursement.

Lorsque vous utilisez l’API, l’état d’un objet Remboursement passe à failed et inclut les attributs suivants :

failure_balance_transaction : l’ID de l’opération sur solde qui représente le montant recrédité sur votre solde Stripe.

failure_reason : La raison pour laquelle le remboursement a échoué. Ces raisons comprennent :

Motif d’échec	Description
`charge_for_pending_refund_disputed`	Un client a contesté le paiement alors que le remboursement était en attente. Dans ce cas, nous vous recommandons d’accepter ou de contester le litige au lieu d’effectuer un remboursement afin d’éviter de rembourser deux fois la somme au client.
`declined`	Remboursement refusé par nos partenaires financiers.
`expired_or_canceled_card`	Le moyen de paiement est annulé par un client ou a expiré par le partenaire.
`insufficient_funds`	Le remboursement est en attente en raison de fonds insuffisants et a dépassé la période d’expiration du remboursement en attente.
`lost_or_stolen_card`	Le remboursement a échoué en raison de la perte ou du vol de la carte d’origine.
`merchant_request`	Le remboursement a échoué à la demande de l’entreprise.
`unknown`	Le remboursement a échoué pour une raison inconnue.

Pour certains moyens de paiement, le code de refus de paiement fourni par nos partenaires financiers, qui indique le motif d’échec du remboursement, est disponible dans le champ network_decline_code du hachage destination_details :

{
  id: "pyr_1234",
  destination_details: {
    blik: {
      network_decline_code: "decline_code"
    },
    type: 'blik',
  }
}

Dans les rares cas où un remboursement échoue, nous vous en informons en utilisant l’événement refund.failed (voir tous les événements liés au remboursement). Si cela se produit, vous devez trouver un autre moyen de rembourser votre client.

Si votre plateforme utilise Connect avec les paiements indirects, les fonds provenant d’un remboursement ayant échoué sont déposés sur le solde Stripe de votre compte de plateforme.

Annuler un remboursement

Selon le type de remboursement, vous pourriez être en mesure d’annuler un remboursement avant qu’il ne parvienne au client. Certains remboursements par carte peuvent être annulés pendant une courte période. Le remboursement ne doit pas avoir été traité comme une annulation de paiement. Seules les annulations du Dashboard sont actuellement prises en charge pour les remboursements par carte.

Pour certains moyens de paiement, Stripe contacte le client pour collecter ses coordonnées bancaires avant de traiter le remboursement. Vous pouvez annuler ces remboursements tant que les coordonnées bancaires n’ont pas été collectées. Pour ce type de remboursements, les annulations depuis l’API et le Dashboard sont prises en charge.

Les remboursements annulés passent à l’état canceled. Les annulations étant un type d’échec de remboursement, les attributs failure_reason et failure_balance_transaction sont inclus dans le remboursement.

Si votre plateforme utilise Connect avec les paiements indirects, les fonds provenant d’un dépôt de remboursement annulé sont versés au solde Stripe du compte de votre plateforme.

Pour annuler un remboursement à l’aide de l’API, annulez un remboursement en fournissant l’ID du remboursement.

Remboursement et annulation

Certains remboursements, c’est-à-dire ceux émis peu après le paiement d’origine, se présentent sous la forme d’une reversalannulation. Dans le cas d’une annulation, le paiement d’origine disparaît du relevé du client et il n’y a pas de crédit.

Les utilisateurs d’IC+ peuvent constater une différence de coût entre les annulations et les remboursements, car les annulations génèrent généralement des frais de réseau moins élevés.

Pour vérifier si un remboursement est effectué sous la forme d’une annulation à l’aide de l’API :

Utilisez l’événement refund.updated ou récupérez le remboursement avec l’API.
S’il s’agit d’une annulation, elle renvoiedestination_details[card][type] = 'reversal'.

Suivre la trace d’un remboursement

Après l’émission d’un remboursement, Stripe transmet la demande de remboursement à l’institution financière ou à l’émetteur de la carte de votre client. Votre client voit le remboursement sous forme de crédit de 5 à 10 jours ouvrables plus tard, en fonction de l’institution financière. Un client peut vous contacter s’il ne voit pas le remboursement. Un remboursement peut ne pas être visible par le client pour plusieurs raisons :

Les remboursements émis peu après le paiement d’origine se présentent sous la forme d’une annulation plutôt que d’un remboursement. Dans le cas d’une annulation, le paiement d’origine est supprimé du relevé du client, et aucun crédit n’est émis.
Un remboursement peut échouer si la banque ou l’émetteur de la carte du client n’a pas pu le traiter correctement, par exemple si le compte bancaire a été fermé ou que la carte présente un problème. La banque nous renvoie alors les fonds, que nous recréditons sur le solde de votre compte Stripe. Ce processus peut prendre jusqu’à 30 jours à compter de l’émission du remboursement.

Si un client vous interroge au sujet d’un remboursement, vous pouvez lui communiquer le numéro de référence principal correspondant au remboursement. Pour les remboursements par carte, il peut s’agir d’un numéro de référence de l’acquéreur (ARN), d’un numéro permettant de retracer l’historique d’un système (STAN) ou d’un numéro de référence de recouvrement (RRN). Le numéro ARN, STAN ou RRN est un numéro de référence attribué à une transaction par carte dans le flux de paiement. Pour les remboursements par mode de paiement local, il peut s’agir d’un numéro de référence généré par Stripe ou nos partenaires financiers qui est propagé aux banques ou institutions bénéficiaires. Le client peut transmettre à son institution financière ce numéro de référence pour obtenir plus d’informations sur la date de la disponibilité du remboursement. Ce numéro de référence permet également de rassurer le client en lui montrant que le remboursement a bien été émis.

Les références de remboursement présentent les spécificités suivantes :

Ils sont pris en charge pour certains partenaires financiers et marqués comme indisponibles dans le cas contraire.
Jusqu’à 7 jours ouvrables sont nécessaires pour recevoir le numéro ARN des partenaires bancaires en aval une fois le remboursement émis.
Aucun numéro ARN n’est disponible dans le cas d’une annulation, car le paiement d’origine n’est pas traité. Pour les réseaux de cartes qui ne prennent pas en charge les ARN, nous essayons de fournir d’autres références telles qu’un numéro permettant de retracer l’historique d’un système (STAN) ou un numéro de référence de recouvrement (RRN).

Pour trouver la référence d’un remboursement à l’aide de l’API :

Utilisez l’événement refund.updated ou récupérez le remboursement avec l’API.
Le cas échéant, Stripe affiche la référence de remboursement de la carte sous la forme API suivante :

{
  id: "re_1234",
  destination_details: {
    card: {
      reference: "123456",
      reference_status: "available",
      reference_type: "acquirer_reference_number",
      type: "refund"
    },
    type: "card",
  }
}

Ou la référence pour les moyens de paiement locaux sélectionnés sous la forme API suivante :

{
  id: "pyr_1234",
  destination_details: {
    eu_bank_transfer: {
      reference: "123456",
      reference_status: "available"
    },
    type: "eu_bank_transfer",
  }
}

Annuler un paiement

Vous pouvez annuler un paiement à l’aide du Dashboard uniquement lorsque son état est uncaptured. Pour annuler un paiement avec d’autres états, vous devez utiliser l’API.

Si vous ne comptez plus encaisser un paiement, vous pouvez annuler un PaymentIntent. Vous pouvez très bien laisser un PaymentIntent à l’état incomplet, par exemple requires_confirmation ou requires_payment_method. En effet, les PaymentIntents incomplets sont utiles pour comprendre le taux de conversion au moment du paiement. L’exemple de code suivant illustre une demande d’annulation de PaymentIntent :

Vous ne pouvez annuler un PaymentIntent que lorsqu’il est dans l’un des états suivants :

requires_payment_method
requires_capture
requires_confirmation
requires_action
processing (uniquement lorsque le moyen de paiement associé est un compte bancaire États-Unis)

Un PaymentIntent ne peut pas être annulé une fois qu’il a réussi. Lorsqu’un PaymentIntent est annulé, vous ne pouvez plus l’utiliser pour traiter d’autres paiements. Toute opération tentée par votre application sur la base d’un PaymentIntent annulé génère une erreur.

Événements de remboursement

Stripe déclenche des événements à chaque création ou modification d’un remboursement. D’autres actions, comme les clôtures de vérifications, déclenchent également des événements relatifs aux remboursements.

Assurez-vous que votre intégration est configurée pour gérer les événements. Vous devez également construire une logique interne pour informer les clients ou votre équipe de l’état du processus de remboursement. Stripe vous recommande au minimum d’écouter l’événement refund.created.

Le tableau suivant décrit les événements les plus courants liés aux remboursements.



`refund.created`	Envoyé à la création d’un remboursement.
`refund.updated`	Envoyé lorsque le remboursement est mis à jour. Les mises à jour comprennent l’ajout de métadonnées et l’inclusion de détails comme l’ARN en tant que numéro de référence pour retracer les remboursements.
`refund.failed`	Envoyé lorsqu’un remboursement a échoué.
`charge.dispute.funds_reinstated`	Envoyé à la restitution, même partielle, de fonds sur votre compte après clôture d’un litige.
`charge.refunded`	Envoyé en cas de remboursement d’un paiement, même partiel. Écoutez `refund.created` pour en savoir plus sur le remboursement.
`review.closed`	Envoyé à la clôture d’une vérification. Consultez le champ `reason` pour connaître le motif de la clôture qui peut être `approved`, `disputed`, `canceled`, `refunded` ou `refunded_as_fraud`.
`source.refund_attributes_required` Deprecated	Envoyé lorsque la source du destinataire a besoin d’attributs de remboursement pour traiter un remboursement ou un paiement erroné.
`charge.refund.updated` Deprecated	Envoyé lorsque le remboursement est mis à jour, uniquement pour les remboursements avec un paiement correspondant. Écoutez plutôt `refund.updated` pour obtenir des mises à jour sur tous les remboursements.

Optimisation des coûts

Si votre entreprise traite un volume important de remboursements peu de temps avant la transaction, nous vous recommandons d’utiliser l’autorisation et la capture manuelles pour réduire vos frais de remboursement. L’autorisation et la capture manuelles vous permettent de mieux contrôler les coûts en annulant les paiements avant qu’ils ne soient capturés, ou en réduisant le montant capturé plutôt que de traiter un remboursement.