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.
- 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
- Consultez decline_code dans last_payment_error du PaymentIntent (ou outcome.reason sur l'objet Charge) pour connaître la vraie raison.
- Associez ce code à la bonne action : attendre une nouvelle tentative, demander une nouvelle carte ou demander au client de s'authentifier.
- 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.
- 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 gratuitementQuestions 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.
Autres codes de refus Stripe
- generic_decline
- do_not_honor
- insufficient_funds
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- incorrect_number
- processing_error
- try_again_later
- transaction_not_allowed
- restricted_card
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Rechercher un code de refus
- La liste complète des codes de refus