Stripe card_declined : signification et comment trouver la vraie raison

Ce que cela signifie

Il s'agit du code d'erreur général de Stripe pour les refus de carte. Le champ `decline_code`, lorsqu'il est renseigné, précise la raison du refus.

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.

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 failure_code sur les anciens objets 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. Réessayer systématiquement chaque card_declined n'est pas une bonne politique : utilisez le code précis pour décider.

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. Vous pouvez également vérifier ou mettre à jour votre carte ici : {link}

Merci,
{company}