Aller au contenu

Outils gratuits / Card Decline / Liste complète

Codes de refus Stripe : la liste complète

Tous les codes de refus de carte renvoyés par Stripe, dans un seul tableau : ce qu'ils signifient, s'il s'agit d'un refus temporaire ou définitif, si une nouvelle tentative avec la même carte peut aboutir, qui peut intervenir (la banque, le client ou vous) et quoi dire au client. Écrit pour les équipes SaaS qui récupèrent des paiements d'abonnement échoués, pas seulement pour les développeurs qui lisent une erreur.

La liste est regroupée selon l'action à mener plutôt que par ordre alphabétique, parce que c'est la question que pose une facture impayée. Chaque code a ici une signification courte ; les plus fréquents ont un guide complet. Le tableau entier se télécharge en JSON, CSV ou Excel, et les mêmes données font tourner l'outil de recherche et un package npm open source.

Abderrahim Ben Jazia, PhDPar · Fondateur de FlowMRR, a créé puis revendu AIS (Avance Immédiate Services), logiciel agréé Urssaf d'avance immédiate du crédit d'impôtMis à jour :

Vérifié par rapport à la référence Stripe des codes de refus le 12 novembre 2026 · 51 codes · 8 catégories · 40 définitifs · 11 temporaires

Télécharger la liste

Les mêmes données que cette page. Le JSON contient les deux langues ; le CSV et l'Excel sont dans la langue de la page, une ligne par code avec le message client et l'e-mail.

JSONCSVExcel (.xlsx)

Licence MIT : utilisez-les dans votre produit, vos e-mails de relance ou vos réponses support.

Temporaire ou définitif ?

Définitif. La même carte est refusée à chaque fois tant que rien ne change (nouvelle carte, limite ou restriction levée, authentification), ou Stripe et les réseaux de cartes demandent de ne pas réessayer. Réessayer après un refus définitif dégrade votre taux d'autorisation et peut coûter des frais réseau.

Temporaire. La banque a refusé sans raison durable. Une tentative ultérieure, par exemple une relance automatique Stripe, peut aboutir.

Refus temporaire (10)

Le refus peut être temporaire. Une relance automatique Stripe peut aboutir si la situation évolue ; un rappel courtois permet aussi au client de vérifier sa carte.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
generic_declineRefus génériqueLe code le plus fréquent : la banque a refusé sans donner de raison, ou Stripe a lui-même bloqué le paiement (Radar, ou Adaptive Acceptance en tarification IC+) avant que la banque ne le voie. outcome.type et outcome.reason permettent de distinguer les deux cas.TemporaireProbableLa banqueGuide
do_not_honorRefus bancaireStripe indique seulement que la banque a refusé pour une raison inconnue et que le client doit la contacter. En pratique, c'est le « non » opaque de la banque (blocage temporaire, règle de dépenses, score de risque de son côté) ; une nouvelle tentative peut aboutir.TemporaireProbableLa banqueGuide
card_declinedCarte refusée (code d'erreur)Ce n'est pas un code de refus mais le code d'erreur Stripe commun à tous les refus de carte. La raison se trouve dans decline_code ; s'il est vide, traitez-le comme un refus générique.TemporairePeut-êtreLa banqueGuide
try_again_laterRéessayer plus tardRefus sans motif communiqué par la banque ; Stripe conseille de retenter plus tard, puis, si le refus persiste, d'inviter le client à contacter sa banque. Stripe indique que ce code est obsolète : il apparaît surtout sur des paiements anciens.TemporaireProbableLa banqueGuide
processing_errorErreur de traitementUne erreur temporaire s'est produite lors du traitement du paiement, généralement du côté de la banque émettrice ou du réseau de cartes.TemporaireProbableLa banqueGuide
issuer_not_availableBanque émettrice indisponibleLa banque du client n'a pas pu être jointe pour autoriser le paiement.TemporaireProbableLa banqueDétails
reenter_transactionTransaction à soumettre à nouveauLa banque émettrice n'a pas pu traiter le paiement et demande une nouvelle tentative.TemporaireProbableLa banqueDétails
approve_with_idIdentification demandéeLa banque demande une vérification d'identité pour autoriser le paiement. Pour un paiement en ligne, ce code est traité ici comme un refus potentiellement temporaire.TemporaireProbableLa banqueDétails
call_issuerContacter la banqueStripe ne donne pas de raison et indique que le client doit contacter sa banque. La réponse réseau sous-jacente demande au titulaire d'appeler sa banque avant que le paiement puisse aboutir, souvent pour une vérification de son côté.TemporairePeut-êtreLe clientDétails
no_action_takenDemande non traitéeStripe ne donne pas de raison et indique que le client doit contacter sa banque ; la réponse réseau signifie que la banque n'a pas traité la demande.TemporairePeut-êtreLa banqueDétails

Fonds insuffisants (1)

Le solde ou le crédit disponible ne couvrait pas le paiement au moment de la tentative. Une nouvelle tentative peut être utile après un approvisionnement du compte.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
insufficient_fundsFonds insuffisantsLe solde du compte ou le crédit disponible était insuffisant au moment de la tentative de paiement.TemporaireProbableLe clientGuide

Limite atteinte (2)

Le paiement dépasse une limite de solde, de crédit ou de transaction fixée sur la carte. La banque continue de refuser cette carte tant que le client ne modifie pas la limite : ne comptez pas sur une nouvelle tentative, demandez une autre carte ou une limite plus élevée.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
withdrawal_count_limit_exceededLimite de retraits dépasséeLe client a dépassé le solde ou la limite de crédit disponible sur sa carte.DéfinitifNonLe clientGuide
card_velocity_exceededLimite de la carte dépasséeLe client a dépassé le solde, la limite de crédit ou le plafond de transaction disponible sur sa carte.DéfinitifNonLe clientGuide

Carte à mettre à jour (16)

La carte enregistrée ou ses informations nécessitent une vérification : expiration, erreur de saisie ou compte clôturé. Demandez au client de corriger les informations ou d'ajouter une autre carte avant de réessayer.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
expired_cardCarte expiréeLa date d'expiration de la carte est dépassée. Les services de mise à jour automatique peuvent actualiser certaines cartes, mais les informations utilisées pour ce paiement restent expirées.DéfinitifNonLe clientGuide
incorrect_numberNuméro de carte incorrectLe numéro de carte saisi est incorrect.DéfinitifNonLe clientGuide
invalid_numberNuméro de carte invalideLe numéro saisi n'est pas un numéro de carte valide.DéfinitifNonLe clientDétails
invalid_accountCompte invalideLa carte ou le compte bancaire associé est invalide ou clôturé.DéfinitifNonLe clientGuide
new_account_information_availableInformations de carte actualisées disponiblesLa carte a été remplacée ; la banque émettrice dispose de nouvelles informations, comme le numéro ou la date d'expiration.DéfinitifNonLe clientDétails
incorrect_cvcCVC incorrectLe code de sécurité saisi ne correspond pas à celui de la carte.DéfinitifNonLe clientGuide
invalid_cvcCVC invalideLe code de sécurité saisi n'est pas valide.DéfinitifNonLe clientDétails
invalid_expiry_monthMois d'expiration invalideLe mois d'expiration saisi n'est pas valide.DéfinitifNonLe clientDétails
invalid_expiry_yearAnnée d'expiration invalideL'année d'expiration saisie n'est pas valide.DéfinitifNonLe clientDétails
incorrect_zipCode postal incorrectLe code postal saisi ne correspond pas à celui enregistré auprès de la banque.DéfinitifNonLe clientDétails
incorrect_addressAdresse incorrecteL'adresse de facturation saisie ne correspond pas à celle enregistrée par la banque.DéfinitifNonLe clientDétails
incorrect_pinCode PIN incorrectLe code PIN saisi est incorrect. Ce cas concerne les paiements effectués avec la carte sur un terminal.DéfinitifNonLe clientDétails
invalid_pinCode PIN invalideLe code PIN saisi n'est pas valide. Ce cas concerne les paiements effectués avec la carte sur un terminal.DéfinitifNonLe clientDétails
pin_try_exceededNombre de tentatives de code PIN dépasséLa carte est bloquée après un trop grand nombre de saisies incorrectes du code PIN.DéfinitifNonLe clientDétails
offline_pin_requiredCode PIN hors ligne requisLa carte exige un code PIN saisi et vérifié sur un terminal de paiement.DéfinitifNonLe clientDétails
online_or_offline_pin_requiredCode PIN requisLa carte exige la saisie d'un code PIN pour autoriser le paiement.DéfinitifNonLe clientDétails

Carte non autorisée (5)

La carte ne peut pas être utilisée pour ce type de paiement (en ligne, récurrent ou international), ou la banque lui a appliqué une restriction. Une nouvelle tentative avec la même carte n'aboutira pas : le client doit faire lever la restriction ou utiliser une autre carte.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
restricted_cardCarte soumise à une restrictionLe client ne peut pas utiliser cette carte pour ce paiement ; Stripe précise qu'elle a pu être déclarée perdue ou volée. Les banques renvoient aussi ce code pour des cartes limitées à certains types d'achat (en ligne, récurrent, international).DéfinitifNonLe clientGuide
transaction_not_allowedTransaction non autoriséeStripe ne donne pas de raison et indique que le client doit contacter sa banque. La réponse réseau signifie en général que la carte n'est pas autorisée pour ce type de transaction (en ligne, récurrente ou internationale).DéfinitifNonLe clientGuide
not_permittedPaiement non autoriséCe paiement n'est pas autorisé avec cette carte ou ce compte.DéfinitifNonLe clientDétails
service_not_allowedService non autoriséStripe ne donne pas de raison et indique que le client doit contacter sa banque ; la réponse réseau signifie que la banque n'autorise pas ce service pour la carte.DéfinitifNonLe clientDétails
do_not_try_againNe pas réessayerStripe ne donne pas de raison et indique que le client doit contacter sa banque ; la réponse réseau demande de ne pas réessayer. Stripe indique que ce code est obsolète : il apparaît surtout sur des paiements anciens.DéfinitifNonLe clientDétails

Authentification requise (3)

La banque demande au titulaire de confirmer le paiement via 3-D Secure ou l'authentification forte (SCA). Une relance automatique ne remplace pas cette étape : envoyez au client le lien vers la page de paiement de sa facture Stripe.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
authentication_requiredAuthentification requiseLa banque exige une authentification forte, par exemple via 3-D Secure, pour autoriser ce paiement. Cela peut se produire lors du premier paiement ou après un changement de carte.DéfinitifNonLe clientGuide
authentication_not_handledAuthentification non effectuéeLié à authentication_required : la banque a demandé une authentification (3-D Secure / SCA), le paiement a été poursuivi sans elle et la banque a de nouveau refusé.DéfinitifNonLe clientDétails
mobile_device_authentication_requiredAuthentification sur l'appareil mobile requiseLa banque demande au client de s'authentifier sur son téléphone ou sa montre (paiement en personne). Stripe conseille de lui faire approcher à nouveau son appareil.DéfinitifNonLe clientDétails

Carte bloquée (8)

La carte est bloquée ou signalée, ou l'autorisation de paiement a été retirée. Ne relancez pas le paiement : les tentatives répétées peuvent réduire votre taux d'autorisation. Contactez le client avec un message neutre.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
fraudulentSuspicion de fraudeStripe a jugé ce paiement potentiellement frauduleux. Présentez au client un refus générique, sans ce motif.DéfinitifNonLe clientGuide
lost_cardCarte perdueLa carte a été déclarée perdue auprès de la banque émettrice.DéfinitifNonLe clientGuide
stolen_cardCarte voléeLa carte a été déclarée volée auprès de la banque émettrice.DéfinitifNonLe clientGuide
pickup_cardCarte à retenirStripe : le client ne peut pas utiliser cette carte pour ce paiement, peut-être parce qu'elle a été déclarée perdue ou volée. Sur les réseaux de cartes, la réponse demande que la carte physique soit retenue.DéfinitifNonLe clientGuide
stop_payment_orderOpposition au paiementStripe ne donne pas de raison et indique que le client doit contacter sa banque. Sur les réseaux de cartes, cette réponse signifie en général que le titulaire a demandé à sa banque de bloquer les paiements à votre entreprise, sans que Stripe le confirme.DéfinitifNonLe clientGuide
revocation_of_authorizationAutorisation de paiement révoquéeStripe ne donne pas de raison et indique que le client doit contacter sa banque. Sur les réseaux de cartes, cette réponse signifie que l'autorisation de ce paiement récurrent a été révoquée, en général par le titulaire, sans que Stripe le confirme.DéfinitifNonLe clientDétails
revocation_of_all_authorizationsToutes les autorisations de paiement révoquéesStripe ne donne pas de raison et indique que le client doit contacter sa banque. Sur les réseaux de cartes, cette réponse signifie que toutes les autorisations de paiement récurrent de la carte ont été révoquées, en général par le titulaire, sans que Stripe le confirme.DéfinitifNonLe clientDétails
security_violationBlocage de sécuritéStripe ne donne pas de raison et indique que le client doit contacter sa banque ; la réponse réseau désigne un blocage de sécurité sur la carte.DéfinitifNonLe clientDétails

Vérification côté marchand (6)

Vérifiez le montant, la devise, les types de cartes acceptés et votre configuration Stripe ou Radar avant de réessayer. Selon le code, une autre carte peut aussi être nécessaire.

CodeCe que cela signifieTemporaire / définitifRéessayer ?Qui intervientGuide
merchant_blacklistBlocage par une liste RadarLe paiement correspond à une règle de blocage dans vos paramètres Stripe Radar, par exemple sur la carte, l'adresse e-mail ou l'adresse IP.DéfinitifNonVousDétails
card_not_supportedCarte non prise en chargeLa carte ne permet pas ce type d'achat. Certaines cartes prépayées ou de débit, par exemple, ne peuvent pas être utilisées pour des paiements récurrents en ligne.DéfinitifNonLe clientGuide
currency_not_supportedDevise non prise en chargeLa carte ne permet pas d'effectuer un paiement dans cette devise.DéfinitifNonLe clientGuide
invalid_amountMontant invalideLe montant n'est pas valide ou dépasse ce que la carte autorise. Stripe : si le montant semble correct, le client vérifie auprès de sa banque qu'un achat de ce montant est autorisé.DéfinitifNonVousDétails
duplicate_transactionTransaction en doubleUne demande de paiement identique a été soumise très récemment.DéfinitifNonVousDétails
testmode_declineRefus lié à une carte de testUne carte de test Stripe a été utilisée en mode production, ou une carte simulant un refus a été utilisée en mode test.DéfinitifNonVousDétails

Valeurs qui ne sont pas des codes de refus

On les colle depuis un objet Charge ou une revue Radar. Elles décrivent un paiement bloqué, pas un refus bancaire, et l'action à mener diffère.

highest_risk_level
highest_risk_level n'est pas un code de refus : c'est l'évaluation du risque de Stripe Radar, qui indique que Radar a lui-même bloqué le paiement avant la décision de la banque. Traitez-le comme une carte bloquée (ne réessayez pas, demandez une autre carte), sauf si vous pensez qu'il s'agit d'un faux positif : vérifiez alors vos règles Radar.
elevated_risk_level
elevated_risk_level n'est pas un code de refus : c'est l'évaluation du risque de Stripe Radar. Radar ne bloque pas ces paiements par défaut ; un paiement en échec avec cette évaluation a donc très probablement été arrêté par l'une de vos propres règles Radar. Vérifiez vos règles de blocage et de revue avant de réessayer ou de demander une autre carte au client.
rule
Ce paiement a été bloqué par Stripe Radar (outcome.type « blocked »), et non refusé par la banque. Avec outcome.reason « rule », c'est l'une de vos propres règles Radar. Vérifiez quelle règle s'est appliquée avant de facturer à nouveau ou de demander une autre carte au client.
low_probability_of_authorization
low_probability_of_authorization n'est pas un code de refus : c'est le outcome.reason d'un paiement bloqué par Adaptive Acceptance (tarification IC+) parce qu'il avait peu de chances d'être autorisé ; la banque ne l'a donc jamais vu. Le code de refus est un generic_decline. Vérifiez la carte et l'historique du client avant de réessayer ; une relance sur le calendrier de Stripe n'est pas bloquée.

Vous avez un code, un message d'erreur ou un webhook ?

Collez-le dans l'outil de recherche : il repère le code de refus, affiche le verdict et vous donne le message client et l'e-mail à envoyer.

Ouvrir l'outil de recherche

Dans votre propre code

Cette liste est le package npm open source stripe-declines (MIT) : les données en JSON, une recherche qui lit les erreurs et webhooks collés, et une ligne de commande. L'outil de recherche de ce site fonctionne avec.

npm install stripe-declines

Le package sur npmLe code source sur GitHub

Questions sur les codes de refus Stripe

Quelle est la différence entre un refus temporaire et un refus définitif ?

Un refus temporaire (soft decline) est un refus sans cause durable : la banque n'a pas pu autoriser le paiement à ce moment-là (generic_decline, do_not_honor, insufficient_funds, try_again_later, processing_error). Une tentative ultérieure peut aboutir, c'est ce qu'exploitent les relances automatiques de Stripe. Un refus définitif (hard decline) signifie que la même carte sera refusée à chaque fois tant que rien ne change : carte expirée, invalide, perdue, volée ou soumise à une restriction, authentification exigée par la banque, ou demande de ne pas réessayer. Après un refus définitif, demandez une autre carte ou l'action manquante ; réessayer ne fait que dégrader votre taux d'autorisation.

Où trouver le code de refus dans Stripe ?

Dans les détails du paiement ayant échoué, dans le tableau de bord Stripe. Dans l'API, c'est `last_payment_error.decline_code` sur le PaymentIntent, `outcome.reason` sur l'objet Charge et `decline_code` sur une erreur de carte. `card_declined` est le code d'erreur générique, pas la raison ; la raison est dans `decline_code`. Stripe renvoie aussi un `advice_code` (`try_again_later`, `do_not_try_again`, `confirm_card_data`) qui indique quoi faire de cette tentative.

Quels codes de refus Stripe peuvent être réessayés ?

Les refus temporaires : generic_decline, do_not_honor, try_again_later, processing_error, issuer_not_available, reenter_transaction, approve_with_id, et insufficient_funds quelques jours plus tard. call_issuer et no_action_taken peuvent aboutir une fois. Tous les autres codes de cette liste sont marqués comme définitifs : données de carte expirées ou invalides, cartes perdues, volées ou bloquées, limites, restrictions, codes d'authentification et codes à corriger de votre côté. Lorsque Stripe fournit un advice_code avec la tentative, suivez-le plutôt que ce tableau.

Peut-on télécharger la liste des codes de refus Stripe ?

Oui, avec les boutons en haut de cette page : JSON (les deux langues, le fichier de données du package), CSV et Excel (une langue, une ligne par code avec la catégorie, le statut temporaire ou définitif, le verdict de relance, qui peut intervenir, la signification, l'action, le message client et l'e-mail client). Les données sont sous licence MIT.

Comment cette liste est-elle maintenue à jour ?

Les données sont vérifiées par rapport à la référence publiée par Stripe ; la date de vérification figure au-dessus du tableau. Les codes, leurs catégories et les verdicts de relance suivent les règles de recouvrement que FlowMRR applique à de vraies factures impayées, et le package open source qui les contient a des tests qui échouent dès qu'un texte contredit le verdict d'un code. Les corrections sont bienvenues sur GitHub, avec la documentation Stripe qui les justifie.

Quels clients refusés contacter en premier ?

FlowMRR lit vos paiements échoués dans Stripe, classe les clients à contacter en priorité et prépare l'e-mail de relance avec le ton adapté à chaque code de refus. Vous le vérifiez et l'envoyez vous-même.

Essayer FlowMRR gratuitement
Nous contacter
FlowMRR

Écrivez-nous

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