Aller au contenu

Card Decline par FlowMRR · Référence gratuite des decline_code Stripe

Comprenez un code de refus Stripe et sachez comment agir.

Collez un code de refus ou un message d'erreur pour comprendre la cause du refus, savoir qui peut intervenir, évaluer l'intérêt d'une relance et copier un modèle d'e-mail client.

La recherche repère les codes connus et les messages standards de Stripe, comme « Votre carte a été refusée. », dans le contenu collé, directement dans votre navigateur.

Exemples:

Parcourir les 51 codes par catégorie

  • Sans clé Stripe
  • Sans inscription
  • Modèle d'e-mail inclus

Gratuit · résultat immédiat · sans clé Stripe ni inscription.

Rechercher un code de refus Stripe

Codes de refus Stripe par catégorie

Regroupés selon l'action à mener. Chaque code renvoie vers sa propre page.

51 codes

Quels clients contacter en priorité, et avec quel message ?

FlowMRR analyse les paiements ayant échoué sur votre compte Stripe connecté, vous aide à prioriser les clients à contacter et prépare des brouillons d'e-mails adaptés aux codes de refus. Vous les vérifiez et les envoyez vous-même.

Essayer FlowMRR gratuitement

Les mêmes règles, dans votre propre code

Tout ce que cette page sait est un package npm open source, stripe-declines : les 51 codes avec leur catégorie, le verdict de relance, qui peut intervenir, un message à afficher au client et un e-mail à envoyer, en anglais et en français. Il lit un code, le message d'erreur Stripe, un objet Charge ou un webhook, et s'installe en ESM, CommonJS, avec les types TypeScript et une ligne de commande. Licence MIT, sans dépendance.

npm install stripe-declines

Dans votre code

import { explain } from "stripe-declines";

explain("do_not_honor"); // { retry: "likely", fixer: "bank", ... }

Le package sur npmLe code source sur GitHub

Pour classer les comptes à relancer après un refus, découvrez la récupération des paiements échoués avec FlowMRR.

Comment traiter un refus de carte Stripe

Un refus, c'est la banque émettrice, Stripe ou le réseau de cartes qui rejette un paiement. Stripe le signale par une erreur card_declined et un decline_code qui en donne la raison, dans la mesure où la banque l'a donnée. La suite dépend de ce code, du conseil que Stripe attache à la tentative et de qui a bloqué le paiement.

Ce qu'est un code de refus

Quand un paiement par carte échoue, Stripe renvoie une erreur dont le code est card_declined et dont le decline_code porte la raison, par exemple insufficient_funds ou expired_card. Sur un PaymentIntent, c'est last_payment_error.decline_code ; sur un objet Charge, outcome.reason ; une facture d'abonnement impayée porte les mêmes champs sur sa tentative de paiement. Le code vient de la réponse de la banque émettrice, traduite par le réseau. Beaucoup de banques répondent do_not_honor ou generic_decline, qui ne disent rien de plus que « non » : la référence Stripe les documente comme un refus pour une raison inconnue, et seule la banque du client en sait davantage.

Refus temporaires et refus définitifs

Un refus temporaire peut se lever de lui-même : un blocage passager, un plafond atteint ce jour-là, une banque injoignable. Une nouvelle tentative avec la même carte peut aboutir ; les relances automatiques de Stripe existent pour ce cas. Un refus définitif ne se lèvera pas tant que rien ne change : carte expirée, numéro erroné, compte clôturé, banque qui demande d'arrêter. Réessayer en l'état ne peut pas fonctionner, et les réseaux de cartes limitent les nouvelles tentatives après certaines réponses, avec des frais au-delà. Cette page classe chaque code dans l'une des deux familles, mais Stripe ne publie pas de liste officielle : ce classement est une valeur par défaut, pas une règle.

Le advice_code prime sur le code

Lorsque la banque en fournit un, Stripe ajoute un advice_code à l'erreur et à l'outcome de l'objet Charge. Il prend trois valeurs : do_not_try_again, try_again_later et confirm_card_data. C'est le verdict de Stripe pour cette tentative, il prime donc sur la règle générale du code. Un do_not_honor avec try_again_later est un refus temporaire ; un do_not_honor avec do_not_try_again est un refus définitif, quoi qu'en dise le tableau. confirm_card_data signifie que les données saisies par le client sont erronées ou périmées : une nouvelle tentative avec les mêmes données échouera. L'outil ci-dessus lit le advice_code d'un payload collé et adapte son verdict.

Les blocages Radar arrivent en card_declined

Tous les refus ne viennent pas de la banque. Quand Stripe Radar bloque un paiement, l'objet Charge échoue bien avec le failure_code card_declined, mais son outcome.type vaut blocked et son outcome.reason vaut highest_risk_level (le score de Radar) ou rule (l'une de vos règles). La banque n'a jamais été interrogée. Réessayer soumet le même paiement aux mêmes règles et échoue de la même façon : un blocage Radar ne doit pas être relancé. Examinez le paiement dans Stripe, corrigez la règle si elle était trop large, ou laissez le client payer autrement. Les blocages d'Adaptive Acceptance apparaissent en generic_decline avec outcome.reason low_probability_of_authorization.

Cartes perdues, volées ou signalées

lost_card, stolen_card, pickup_card et fraudulent signifient que la banque a signalé la carte, pas le client. Stripe demande de présenter ces refus au client comme un refus générique, sans en donner la raison : la personne qui paie peut être le titulaire légitime d'une carte signalée par erreur, et sinon, révéler ce qui a été détecté aiderait un fraudeur. Les messages client de cette page suivent cette règle. En interne, traitez-les comme des refus définitifs : arrêtez les tentatives, demandez une autre carte et gardez le vrai code pour vos archives.

Comprendre les codes de refus Stripe

Guides associés

Où trouver le code de refus dans Stripe ?

Ouvrez les détails du paiement ayant échoué dans le tableau de bord Stripe. Dans l'API, consultez `last_payment_error.decline_code` sur le PaymentIntent, ou `outcome.reason` sur l'objet Charge. `card_declined` indique un refus de carte de manière générale ; `decline_code`, lorsqu'il est renseigné, précise la raison du refus.

Faut-il réessayer un paiement refusé ?

Cela dépend du code. Pour un refus temporaire (generic_decline, do_not_honor, insufficient_funds, try_again_later), les relances automatiques de Stripe peuvent être utiles, sans garantie de réussite. Une carte expirée ou bloquée (expired_card, lost_card, stolen_card, fraudulent) nécessite une intervention ou un autre moyen de paiement : ne multipliez pas les tentatives sans changement. Si une authentification est requise, le client doit confirmer le paiement.

Les tentatives répétées après un refus définitif présentent-elles un risque ?

Oui, et cela peut vous coûter directement. Visa et Mastercard encadrent les nouvelles tentatives après un refus : lorsque la banque indique que le paiement ne sera jamais accepté (carte perdue ou volée, compte clôturé, réponse « ne pas réessayer »), toute nouvelle tentative enfreint leurs règles, et les autres refus sont limités à un nombre de tentatives sur une période glissante. Au-delà, le réseau peut facturer des frais sur chaque tentative excédentaire, en plus de la baisse de votre taux d'autorisation. Après un refus définitif, cessez les tentatives et demandez au client un autre moyen de paiement.

Pourquoi une nouvelle tentative peut-elle réussir après un refus do_not_honor ?

Ce code ne précise pas la raison du refus. Il peut correspondre à un blocage temporaire, à une limite de fréquence des transactions ou à une évaluation du risque par la banque. Une tentative ultérieure peut réussir si la situation évolue, mais ce n'est pas garanti. Si le refus persiste, invitez le client à contacter sa banque.

Cet outil est-il connecté à mon compte Stripe ?

Non. Aucune connexion à votre compte Stripe ni clé API n'est nécessaire. L'outil s'appuie sur un catalogue de codes documentés par Stripe ; la recherche dans le contenu collé est traitée dans votre navigateur. Le code consulté peut être enregistré à des fins de mesure d'utilisation, mais pas le contenu brut que vous collez.

Puis-je utiliser ces règles dans ma propre application ?

Oui. Les données et la recherche de cette page sont publiées sous forme de package npm open source, stripe-declines (licence MIT), le même code que cette page exécute. `npm install stripe-declines`, puis `explain("do_not_honor")` ou `customerMessage(error.decline_code, "fr")` renvoient le verdict, l'action et le message client ; la commande `stripe-declines` fait de même depuis un terminal. Les corrections sont bienvenues sur GitHub, avec la documentation Stripe qui les justifie.

Nous contacter
FlowMRR

Écrivez-nous

Une question, un souci technique ou une idée de partenariat ? Échangez avec l'équipe FlowMRR.