PAIEMENTS ÉCHOUÉS

Refus générique (generic decline) : ce que ça veut dire et que faire

Un refus générique est un refus de carte sans raison donnée. Distinguer un refus de la banque d’un blocage antifraude, quand relancer, quoi dire au client.

Publié le 10 min de lecture

Refus générique (generic decline) : ce que ça veut dire et que faire

Un refus générique signifie que le paiement a été refusé sans raison précise. La plupart du temps, la banque du client a dit non et a gardé la raison pour elle ; seul le titulaire de la carte peut l’obtenir, en contactant sa banque. Sur Stripe, pourtant, generic_decline peut aussi vouloir dire que la banque n’a jamais vu le paiement, parce que Stripe Radar ou Adaptive Acceptance l’a bloqué avant. Avant de relancer ou de dire à un client d’appeler sa banque, vérifiez donc où le paiement s’est arrêté.

Ce guide explique ce que signifie le code sur Stripe, Braintree, Adyen et Recurly, comment distinguer un refus de la banque émettrice d’un blocage par votre propre prestataire, quand une relance est permise et quoi écrire au client. Chaque règle ci-dessous vient de la documentation des prestataires eux-mêmes, listée dans les sources.

Que signifie un refus générique ?

Quand un paiement par carte est envoyé pour autorisation, la banque émettrice répond par un code de réponse. Certains codes sont précis : fonds insuffisants, carte expirée, CVC incorrect. D’autres disent seulement « refusé ». Le guide des refus de carte de Stripe le dit clairement : les banques émettrices classent la plupart des refus comme génériques, « ce qui rend la raison exacte du refus peu claire ». Il ajoute que, pour des raisons de confidentialité et de sécurité, les banques émettrices ne discutent du détail d’un refus qu’avec les titulaires de leurs cartes.

Un refus générique n’est donc pas un diagnostic. Derrière, il peut y avoir un filtre antifraude de la banque, un plafond, un solde bas, une carte bloquée pour les paiements en ligne ou une règle interne. Le code ne permet pas de savoir lequel, ni à vous ni à votre prestataire de paiement.

Stripe décrit generic_decline ainsi : « La carte a été refusée pour une raison inconnue, ou Stripe Radar ou Adaptive Acceptance a bloqué le paiement. » L’étape suivante qu’il indique : le client doit contacter sa banque émettrice pour en savoir plus. Son proche cousin, do_not_honor, a la même étape suivante mais seulement la première moitié de la description : « refusée pour une raison inconnue ». Pour ce code, voir le guide do not honor.

Le paiement est-il seulement arrivé jusqu’à la banque ?

C’est la question que la plupart des équipes oublient. La vue d’ensemble des refus de Stripe liste trois raisons d’échec d’un paiement : les refus de la banque émettrice, les paiements bloqués et les appels API invalides. Elle indique que, quand Stripe bloque un paiement, « il n’obtient pas d’autorisation de la banque émettrice ». Demander au client d’appeler sa banque pour un paiement que la banque n’a jamais reçu lui fait perdre son temps, et à vous aussi.

Sur Stripe, l’objet outcome du paiement vous dit dans quel cas vous êtes :

outcome.type outcome.network_status Ce qui s’est passé Que faire
issuer_declined declined_by_network La banque a refusé le paiement Lire le code de conseil ; relancer plus tard ou demander une autre carte
blocked not_sent_to_network Stripe l’a bloqué avant la banque (Radar ou Adaptive Acceptance) Regarder outcome.reason et vos règles Radar ; un appel à la banque n’aidera pas
invalid not_sent_to_network L’appel API lui-même était erroné Corriger la requête ; rien à dire au client

Pour un paiement bloqué, outcome.reason dit pourquoi : highest_risk_level pour la règle de blocage par défaut de Radar, rule pour l’une de vos règles personnalisées, et low_probability_of_authorization quand Adaptive Acceptance a jugé que le paiement avait peu de chances d’être autorisé. Le champ outcome.seller_message donne une phrase comme « Stripe a bloqué ce paiement car il est trop risqué. »

Les autres prestataires font la même distinction, avec leurs propres mots :

  • Braintree sépare un refus du processeur, qui « indique que la banque du client a refusé la demande de transaction », d’un rejet de la passerelle, qui est « bloqué par les réglages de votre passerelle Braintree » (outils antifraude, règles CVV ou AVS, doublons, seuils de risque et autres). Un rejet de la passerelle affiche le statut « Gateway Rejected » avec une raison.
  • Adyen renvoie la raison de refus 2 « Refused » pour un simple refus, et 20 « FRAUD » quand ses contrôles de risque avant autorisation ont donné un score de fraude de 100 ou plus.
  • Recurly range les erreurs par catégorie. declined est dans Soft ; des codes comme fraud_gateway (« a refusé la transaction à cause des filtres antifraude activés dans votre passerelle ») et fraud_risk_check sont dans Fraud.

Si vous facturez avec Chargebee, Zuora ou Maxio par-dessus l’une de ces passerelles, cherchez le code propre à la passerelle dans le détail de l’erreur du paiement : c’est là que la distinction apparaît.

Quatre étapes après un refus générique
  1. 01 Voir où le paiement s’est arrêté outcome.type et network_status : refus de la banque, ou blocage par votre propre prestataire
  2. 02 Lire le code de conseil try_again_later, do_not_try_again ou confirm_card_data
  3. 03 Réessayer en espaçant sur plusieurs jours Dans les limites des réseaux, jamais en boucle rapide
  4. 04 Demander une autre carte Ou un appel à la banque ; réessayer aussitôt la carte mise à jour

Comment chaque prestataire appelle-t-il un refus générique ?

Où Refus générique Conseils de relance dans la documentation
Stripe decline_code: generic_decline (aussi do_not_honor) Lire outcome.advice_code
Braintree 2046 Declined ; aussi 2000 Do Not Honor et 2038 Processor Declined Tous les trois marqués temporaires (soft)
Adyen Raison de refus 2 « Refused » Non indiqué sur la page des raisons de refus
Recurly declined, aussi declined_saveable (« refusé sans information précise ») Listé dans Soft

Deux détails aident à lire ces codes :

  • Le texte de Braintree pour 2000 Do Not Honor le qualifie de « refus générique », et pour 2046 Declined indique de contacter la banque pour les paiements par carte, le support PayPal pour PayPal et le support Venmo pour Venmo.
  • Adyen a une raison de refus distincte, 27 « Declined Non Generic », pour les réponses qui « ne peuvent pas être associées de façon fiable ». Selon Adyen, cela permet de distinguer plus facilement les refus génériques, comme le Mastercard « 05: Do not honor », des refus plus précis.

Faut-il relancer un refus générique ?

En général oui, un nombre limité de fois et en espaçant, sauf si un code de conseil dit d’arrêter. Braintree et Recurly classent leurs codes génériques comme refus temporaire, qu’une relance plus tard peut régler, mais c’est le code de conseil qui l’accompagne qui a le dernier mot.

Sur Stripe, lisez outcome.advice_code :

  • try_again_later : la banque émettrice a refusé, mais vous pouvez relancer.
  • do_not_try_again : ne réutilisez pas la carte pour cette transaction.
  • confirm_card_data : certaines données de la carte sont erronées ; le client doit les vérifier.

Un blocage Radar porte aussi un code de conseil : l’exemple de paiement bloqué de Stripe montre do_not_try_again. Le relancer tel quel ne ferait que déclencher la même règle.

Limites des réseaux de cartes. L’article de Braintree sur les refus donne les catégories de relance Visa telles qu’elles s’appliquent à ses marchands. 2000 Do Not Honor est dans la catégorie 4 et 2046 Declined dans la catégorie 2 ; les deux sont limités à 15 relances sur 30 jours glissants. Au-delà du seuil, les frais sont de 0,10 $ par transaction nationale et 0,15 $ par transaction internationale. Pour Mastercard, Braintree indique que les relances « doivent se fonder uniquement sur les Merchant Advice Codes », et Mastercard facture 0,10 $ pour chaque nouvelle tentative au-delà de 10 relances en 24 heures pour les MAC 03 et 21.

Le plafond de Stripe est plus bas. Son guide des refus de carte recommande au maximum huit relances pour les paiements qui en autorisent, et prévient que les banques émettrices peuvent voir des relances supplémentaires comme une fraude potentielle, ce qui peut provoquer davantage de refus sur des paiements légitimes. Adyen a même une raison de refus, 46, pour les transactions qu’il a bloquées lui-même « pour s’assurer que vous ne payez pas de pénalités » liées à des relances excessives.

En pratique, pour un renouvellement qui échoue avec un refus générique :

  1. Vérifiez d’abord outcome.type. Si le paiement a été bloqué par votre propre prestataire, revoyez la règle ; ne planifiez pas de relances.
  2. Ne relancez jamais en boucle serrée. La même demande une minute plus tard obtiendra très probablement la même réponse, et elle compte dans les limites des réseaux.
  3. Espacez les relances sur plusieurs jours. Si la cause cachée était un solde bas ou un plafond journalier, un autre jour a plus de chances.
  4. Arrêtez sur un signal « do not try again » (do_not_try_again de Stripe, MAC Mastercard 03 ou 21) et demandez un autre moyen de paiement.
  5. Relancez aussitôt quand le client met à jour sa carte, au lieu d’attendre la prochaine tentative prévue.

La façon dont Stripe, Chargebee, Recurly et d’autres planifient leurs relances est comparée dans les calendriers de relance comparés.

Que dire au client ?

Dites-lui que sa banque a refusé le paiement et donnez-lui deux solutions : contacter la banque, ou utiliser une autre carte. N’affichez jamais « generic_decline » ni un code brut.

Un message générique est aussi le choix sûr par défaut quand la vraie raison est sensible. La référence de Stripe indique de présenter les refus fraudulent, lost_card, stolen_card et merchant_blacklist de la même manière que generic_decline, sans plus de détail. La page des raisons de refus d’Adyen indique de ne pas montrer aux acheteurs le détail de la raison du refus, « pour éviter un usage malveillant ». Le message client de Recurly pour declined suit la même logique : « Votre transaction a été refusée. Veuillez utiliser une autre carte ou contacter votre banque. »

Un email de renouvellement pour un refus de la banque émettrice peut dire :

Objet : Votre paiement pour [Produit] n’est pas passé

Bonjour [Prénom],

Votre banque a refusé le paiement de ce mois-ci de [montant] pour [Produit]. Les banques ne disent pas toujours pourquoi. C’est souvent un blocage temporaire qu’un appel ou un message rapide à votre banque suffit à lever.

Vous pouvez aussi utiliser une autre carte ici : [lien de mise à jour]

Nous réessaierons le [date]. Si votre banque lève le blocage d’ici là, vous n’avez rien à faire.

Pour un paiement bloqué par vos propres règles antifraude, l’email est différent : n’envoyez pas le client vers sa banque. Si le client semble légitime après vérification, demandez-lui de réessayer ou d’utiliser un autre moyen de paiement, ou ajustez la règle. D’autres modèles sont dans les codes de refus Stripe expliqués.

Quelles erreurs éviter ?

  • Considérer chaque refus générique comme la faute de la banque. Sur Stripe, vérifiez outcome.type et network_status avant d’écrire au client.
  • Relancer un paiement bloqué. Une règle Radar ou de passerelle bloquera de nouveau la même demande.
  • Ignorer le code de conseil. Le même refus générique peut venir avec « try again later » ou « do not try again ».
  • Demander au client de ressaisir sa carte sans regarder. Stripe conseille d’examiner les vérifications du CVC et de l’adresse (AVS) quand une carte renvoie un refus générique ou do_not_honor, et de demander au client de vérifier ces données si une vérification a échoué.
  • Révéler la vraie raison. Si le code derrière le message générique est stolen_card ou fraudulent, le client voit quand même un refus générique.

Comment tester un refus générique ?

La carte de test Stripe 4000000000000002 renvoie une erreur card_declined avec le code de refus generic_decline. Utilisez-la en mode test pour vérifier que votre checkout affiche le bon message et que votre parcours de renouvellement envoie l’email, planifie la relance et s’arrête quand la carte est mise à jour.

Comment NoChurn aide

NoChurn lit le code de refus et l’historique de chaque renouvellement échoué. Pour les refus temporaires comme un refus générique, les relances tombent sur les jours de paie probables, dans le fuseau horaire du client, à l’intérieur des jours et des heures que vous autorisez ; ou vous gardez les relances de votre prestataire, comme les Smart Retries de Stripe. Les emails de récupération partent par défaut à J0, J3, J7 et J14, chacun rédigé par l’IA pour ce client et ce refus, et vérifié avant l’envoi ; ils n’affichent jamais le code brut, et chacun renvoie vers une page hébergée de mise à jour de carte, sans connexion. Voir les paiements échoués.

FAQ

Que signifie « generic decline » sur un paiement par carte ?

Le paiement a été refusé sans raison précise. En général, la banque du client l’a refusé et ne donne la raison qu’au titulaire de la carte. Sur Stripe, generic_decline peut aussi vouloir dire que Stripe Radar ou Adaptive Acceptance a bloqué le paiement avant qu’il n’arrive à la banque.

Un refus générique est-il la même chose que « do not honor » ?

Ils sont proches. Les deux sont des refus sans raison donnée, et Stripe leur donne la même étape suivante : le client contacte sa banque. La différence sur Stripe : generic_decline couvre aussi les paiements bloqués par Radar ou Adaptive Acceptance.

Peut-on relancer un refus générique ?

En général, si vous attendez et que le code de conseil le permet. Braintree marque ses codes génériques comme temporaires (soft), et Visa limite ces catégories à 15 relances sur 30 jours glissants. Arrêtez sur do_not_try_again de Stripe ou sur les MAC Mastercard 03 ou 21.

Comment savoir si Stripe Radar a bloqué le paiement ?

Regardez l’objet outcome du paiement. Un blocage Radar a type: blocked et network_status: not_sent_to_network, avec une reason comme highest_risk_level ou rule. Un refus de la banque émettrice a type: issuer_declined et network_status: declined_by_network.

Pourquoi la banque ne me donne-t-elle pas la raison ?

Stripe indique que, pour des raisons de confidentialité et de sécurité, les banques émettrices ne discutent du détail d’un refus qu’avec les titulaires de leurs cartes. Votre prestataire transmet les codes qu’il reçoit, rien de plus.

Sources

Tous consultés le 17 novembre 2026.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Arrêtez de perdre du revenu.

  • Gratuit jusqu’à 300 € de MRR
  • Sans carte bancaire
  • Prêt en 10 minutes
  • Sans commission