Aller au contenu

Outils gratuits / Codes de refus Stripe / card_declined

Erreur Stripe card_declined : lire le decline_code et récupérer le MRR

card_declined est le code d'erreur général de Stripe pour un paiement par carte refusé. Il n'explique pas à lui seul la cause. Le détail utile se trouve dans le champ decline_code qui l'accompagne généralement.

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 :
Code de refus
card_declined
Type
Refus temporaire
Qui peut intervenir
La banque — se débloque souvent avec le temps
Une nouvelle tentative peut-elle être utile ?
Peut-être : réessayez une fois, puis demandez une autre carte

Ce que cela signifie

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.

Pourquoi cela arrive

  • La banque a refusé le paiement pour une raison qui peut figurer dans decline_code.
  • Une raison durable, comme une carte expirée, perdue ou bloquée.
  • Une raison temporaire, comme des fonds insuffisants ou un refus passager de la banque.
  • Aucun détail lorsque la banque n'en transmet pas.

Que faire

  1. Consultez decline_code dans last_payment_error du PaymentIntent (ou outcome.reason sur l'objet Charge) pour connaître la vraie raison.
  2. Associez ce code à la bonne action : attendre une nouvelle tentative, demander une nouvelle carte ou demander au client de s'authentifier.
  3. Si decline_code est vide, traitez le refus comme un refus générique : une tentative espacée et un e-mail de mise à jour de la carte.
  4. Conservez le code par client pour repérer facilement les refus répétés.

Faut-il réessayer ?

Tout dépend du decline_code sous-jacent : suivez le code précis lorsqu'il est présent. Sans decline_code, traitez-le comme un refus générique : une nouvelle tentative espacée, puis demandez une autre carte au client. Réessayer systématiquement chaque card_declined n'est pas une bonne politique.

Que dire au client

Court et neutre, prêt pour une erreur au paiement, une page de facturation ou une réponse au support. Sans champ à remplacer — prêt à coller.

Votre carte a été refusée. Réessayez, ou utilisez une autre carte. Si le refus se répète, votre banque pourra vous en indiquer la raison.

Modèle d'e-mail au client

Formulation neutre pour cette situation. Remplacez {name}, {product}, {link} et {company}.

Bonjour {name},

Votre banque a refusé notre dernière tentative de paiement pour {product}. Ce refus peut être temporaire. Si les relances automatiques sont activées, une nouvelle tentative aura lieu dans les prochains jours. Si le refus se répète, votre banque pourra vous en indiquer la raison. Vous pouvez également vérifier ou mettre à jour votre carte ici : {link}

Merci,
{company}

Beaucoup de paiements échoués ? Découvrez comment FlowMRR aide à prioriser les paiements Stripe échoués selon le revenu à risque. Envie d'une liste classée à partir de votre compte ? Essayez l' audit gratuit des paiements échoués.

Essayer FlowMRR gratuitement

Questions fréquentes

Où trouver le code de refus dans Stripe ?

Dans les détails du paiement du tableau de bord Stripe, ou dans l'API via last_payment_error.decline_code sur le PaymentIntent (ou outcome.reason sur l'objet Charge).

card_declined est-il identique à generic_decline ?

Non. card_declined est l'erreur générale ; generic_decline est une raison de refus précise qui peut s'y trouver.

Nous contacter
FlowMRR

Écrivez-nous

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