# Codes de refus de Stripe

Apprenez à interpréter les codes de refus de Stripe et à les résoudre en cas d’échec de paiement.

Stripe utilise ses propres codes de refus de paiement, dont une grande partie couvrent des motifs potentiels similaires à ceux fournis par les [codes de refus de paiement reçus par l’émetteur](https://docs.stripe.com/declines/network-codes.md). Les codes de refus de paiement Stripe approfondissent néanmoins la raison spécifique du refus de paiement. En plus d’un code de refus, une erreur peut contenir un [advice_code](https://docs.stripe.com/declines/card.md#retrying-issuer-declines) avec des suggestions pour résoudre le problème.

> #### Autres erreurs API
> 
> Certaines [erreurs API](https://docs.stripe.com/api/errors.md) incluent un attribut [code](https://docs.stripe.com/api/errors.md#errors-code) pour vous aider à [les résoudre](https://docs.stripe.com/error-handling.md).

## Codes de refus de carte

Voici les codes de refus de paiement de Stripe utilisés pour paiements par carte :

| Code de refus de paiement | Description | Prochaines étapes |
| --- | --- | --- |
| `authentication_required` | La carte a été refusée car la transaction nécessite une authentification telle que *3D Secure* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments). | Lorsque vous utilisez les interfaces front-end de Stripe, dans la plupart des cas, un refus de paiement temporaire de l’émetteur déclenche un processus d’authentification, ce qui permet au client de réessayer et d’authentifier sa carte bancaire. Dans certains cas, notamment pour les *paiements hors session* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information), vous devrez peut-être demander au client de réessayer. Si l’émetteur de la carte renvoie ce [code de refus de paiement](https://support.stripe.com/questions/authenticated-payment-declined-with-an-authentication-required-decline-code) malgré l’authentification réussie de la transaction, le client doit contacter l’émetteur de sa carte pour obtenir davantage d’informations. |
| `authentication_not_handled` | Lié à `authentication_required`. Le client a tenté de poursuivre sans effectuer l’authentification requise. L’émetteur a donc de nouveau refusé le paiement. | Exécutez le flux EMV 3D Secure (3DS) ou d’authentification forte du client (SCA). Pour les paiements hors session, collectez et préparez d’abord l’authentification pendant une session, puis revenez pendant une session si nécessaire. |
| `approve_with_id` | Le paiement ne peut pas être autorisé. | Retentez le paiement. Si vous ne pouvez toujours pas le traiter, le client doit contacter l’émetteur de sa carte. |
| `call_issuer` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `card_not_supported` | La carte bancaire ne prendre en charge ce type d’achat. | Le client doit contacter l’émetteur de sa carte afin de s’assurer que sa carte peut être utilisée pour effectuer ce type d’achat. |
| `card_velocity_exceeded` | Le client a dépassé le solde, le plafond de crédit ou la limite du montant de la transaction disponible sur sa carte bancaire. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `currency_not_supported` | La carte bancaire ne prendre en charge la devise spécifiée. | Le client doit contacter l’émetteur de la carte afin de vérifier si elle peut être utilisée pour le type de devise spécifié. |
| `do_not_honor` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| (Obsolète)`do_not_try_again` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `duplicate_transaction` | Une transaction présentant un montant et des informations de carte bancaire identiques a été soumise très récemment. | Vérifiez si ce paiement n’existe pas déjà. |
| `expired_card` | La carte a expiré. | Le client doit utiliser une autre carte. |
| `fraudulent` | Le paiement a été refusé car Stripe l’a identifié comme potentiellement frauduleux. | Ne communiquez pas d’informations plus détaillées à votre client. Présentez plutôt le refus de paiement de la même manière que `generic_decline`. |
| `generic_decline` | La carte bancaire a été refusée pour une raison inconnue ou Stripe Radar ou Adaptive Acceptance [a bloqué le paiement](https://docs.stripe.com/declines.md#blocked-payments). | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `incorrect_address` | L’adresse saisie par le client est incorrecte. | Le client doit réessayer avec la bonne adresse. |
| `incorrect_cvc` | Le numéro CVC est incorrect. | Le client doit réessayer avec le bon CVC. |
| `incorrect_number` | Le numéro de carte est incorrect. | Le client doit réessayer avec le bon numéro de carte bancaire. |
| `incorrect_pin` | Le code PIN saisi est erroné. Ce code de refus s’applique uniquement aux paiements effectués avec un lecteur de cartes. | Le client doit réessayer avec le bon code PIN. |
| `incorrect_zip` | Le code postal est incorrect. | Le client doit réessayer en utilisant le bon code postal de facturation. |
| `insufficient_funds` | La carte bancaire ne dispose pas de fonds suffisants pour effectuer l’achat. | Le client doit utiliser un autre moyen de paiement. |
| `invalid_account` | La carte bancaire, ou le compte auquel elle est connectée, n’est pas valide. | Le client doit contacter l’émetteur de la carte pour s’assurer qu’elle fonctionne correctement. |
| `invalid_amount` | Le montant du paiement n’est pas valide ou dépasse le montant autorisé. | Si le montant semble correct, le client doit contacter l’émetteur de la carte pour s’assurer qu’il est autorisé à effectuer un achat de ce montant. |
| `invalid_cvc` | Le numéro CVC est incorrect. | Le client doit réessayer avec le bon CVC. |
| `invalid_expiry_month` | Le mois d’expiration n’est pas valide. | Le client doit réessayer en utilisant la bonne date d’expiration. |
| `invalid_expiry_year` | L’année d’expiration n’est pas valide. | Le client doit réessayer en utilisant la bonne date d’expiration. |
| `invalid_number` | Le numéro de carte est incorrect. | Le client doit réessayer avec le bon numéro de carte bancaire. |
| `invalid_pin` | Le code PIN saisi est incorrect. | Le client doit réessayer avec le bon code PIN. |
| `issuer_not_available` | L’émetteur de la carte n’étant pas joignable, le paiement n’a pas pu être autorisé. | Retentez le paiement. Si vous ne pouvez toujours pas le traiter, le client doit contacter l’émetteur de sa carte. |
| `lost_card` | Le paiement a été refusé, car la carte bancaire a été déclarée perdue. | Le motif spécifique du refus de paiement ne doit pas être communiqué au client. Présentez plutôt le refus comme `generic_decline`. |
| `merchant_blacklist` | Le paiement a été refusé, car il correspond à une entrée de la liste de blocage de l’utilisateur Stripe. | Ne communiquez pas d’informations plus détaillées à votre client. Présentez plutôt le refus de paiement de la même manière que `generic_decline`. |
| `new_account_information_available` | La carte bancaire, ou le compte auquel elle est connectée, n’est pas valide. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `no_action_taken` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `not_permitted` | Le paiement n’est pas autorisé. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `offline_pin_required` | La carte a été refusée, car un code PIN est requis. | Le client doit réessayer en insérant sa carte et en saisissant un code PIN. |
| `online_or_offline_pin_required` | La carte a été refusée, car un code PIN est requis. | Si le lecteur de cartes prend en charge le code PIN en ligne, invitez le client à saisir son code PIN sans créer une nouvelle transaction. Dans le cas contraire, le client doit réinsérer sa carte et saisir son code PIN. |
| `pickup_card` | Le client ne peut pas utiliser cette carte pour effectuer ce paiement (il est possible qu’elle ait été déclarée perdue ou volée). | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `pin_try_exceeded` | Le nombre de tentatives autorisées de saisie du code PIN a été dépassé. | Le client doit utiliser une autre carte bancaire ou un autre moyen de paiement. |
| `processing_error` | Une erreur s’est produite lors du traitement de la carte bancaire. | Demandez au client de réessayer d’effectuer le paiement. S’il ne peut toujours pas être traité, le client doit contacter l’émetteur de sa carte bancaire. |
| `reenter_transaction` | Le paiement n’a pas pu être traité par l’émetteur de la carte pour une raison inconnue. | Vous devez retenter le paiement. S’il ne peut toujours pas être traité, le client doit contacter l’émetteur de sa carte. |
| `restricted_card` | Le client ne peut pas utiliser cette carte pour effectuer ce paiement (il est possible qu’elle ait été déclarée perdue ou volée). | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `revocation_of_all_authorizations` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `revocation_of_authorization` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `security_violation` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `service_not_allowed` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `stolen_card` | Le paiement a été refusé, car la carte bancaire a été déclarée volée. | Ne communiquez pas d’informations plus détaillées à votre client. Présentez plutôt le refus de paiement de la même manière que `generic_decline`. |
| `stop_payment_order` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| `testmode_decline` | La carte utilisée est une carte de test Stripe. | Utilisez une véritable carte bancaire pour effectuer le paiement. |
| `transaction_not_allowed` | La carte a été refusée pour une raison inconnue. | Le client doit contacter l’émetteur de la carte pour en savoir plus. |
| (Obsolète)`try_again_later` | La carte a été refusée pour une raison inconnue. | Demandez au client de retenter le paiement. Si les paiements suivants sont refusés, le client devra alors contacter l’émetteur de sa carte pour en savoir plus. |
| `withdrawal_count_limit_exceeded` | Le client a dépassé le solde ou la limite de crédit disponible sur sa carte bancaire. | Le client doit utiliser un autre moyen de paiement. |
| `mobile_device_authentication_required` | La carte a été refusée, car la transaction nécessite une authentification. | Demandez au client de réessayer le paiement en approchant de nouveau son appareil mobile. |

## Codes de refus de paiement des moyens de paiement locaux

Les codes de refus de paiement Stripe suivants peuvent être utilisés pour les moyens de paiement locaux (LPM) :

À partir de la version de l’API `2026-09-30.endive`, les paiements BLIK peuvent renvoyer `code_invalid`, `code_expired`, `insufficient_funds`, `customer_declined`, `payment_limit_exceeded` et `partner_generic_decline`. Les anciennes versions de l’API renvoient `generic_decline` pour ces échecs BLIK.

| Code de refus de paiement | Motif du résultat de paiement | Message du marchand | Message d’erreur de l’API |
| --- | --- | --- | --- |
| `partner_generic_decline` | `partner_generic_decline` | Le prestataire de services de paiement a refusé le paiement. | Le prestataire de services de paiement a refusé le paiement. |
| `customer_declined` | `generic_decline` | Le client a refusé le paiement. | Le client a refusé ce paiement. |
| `code_invalid` | `generic_decline` | Le code BLIK est non valide ou mal formé. | Le code transmis n’était pas un code BLIK valide. |
| `code_expired` | `generic_decline` | Le code BLIK a expiré, a déjà été utilisé ou a dépassé sa durée de validité. | Le code transmis a expiré. Les codes BLIK expirent après 2 minutes. Veuillez demander au client un autre code. |
| `invalid_customer_account` | `invalid_customer_account` | Nous ne pouvons pas débiter le compte du client. | Impossible de débiter le compte du client. Les nouvelles tentatives pourront aboutir une fois que le client aura résolu le problème. |
| `payment_limit_exceeded` | `payment_limit_exceeded` | La commande dépasse une limite définie sur le compte du client. | Le montant de la commande est supérieur à une limite définie sur le compte du client. Les nouvelles tentatives pourront aboutir une fois que le client aura résolu le problème. |
| `invalid_billing_agreement` | `invalid_billing_agreement` | Le contrat de facturation du client n’est pas valide. | Le moyen de paiement du client n’est pas valide en raison d’un contrat de facturation non conforme. Toute nouvelle tentative échouera. |
| `expired_card` | `partner_expired_card` | La carte bancaire enregistrée auprès du prestataire de services de paiement a expiré. | La carte bancaire enregistrée auprès du prestataire de services de paiement a expiré. Les nouvelles tentatives pourront aboutir une fois que le client aura résolu le problème. |
| `processing_error` | `partner_processing_error` | Le prestataire de services de paiement a rencontré une erreur lors du traitement. | Le prestataire de services de paiement a rencontré une erreur lors du traitement. |
| `insufficient_funds` | `partner_insufficient_funds` | Le client n’a pas suffisamment de fonds auprès du prestataire de services de paiement. | Le compte du client auprès du prestataire de services de paiement ne dispose pas de fonds suffisants. Les nouvelles tentatives pourront aboutir une fois que le client aura résolu le problème. |
| `currency_not_supported` | `partner_invalid_currency` | Le prestataire de services de paiement ne prend pas en charge cette devise. | Le prestataire de services de paiement ne prend pas en charge cette devise. Toute autre tentative échouera. |
| `invalid_amount` | `partner_invalid_amount` | Le prestataire de services de paiement n’autorise pas le montant. | Le prestataire de services de paiement n’autorise pas le montant. Toute autre tentative échouera. |
| `invalid_business_account` | `invalid_business_account` | Le compte (bancaire) commercial est désactivé. | Le compte de l’entreprise que vous tentez d’utiliser pour traiter un paiement ou effectuer un remboursement est désactivé et ne peut ni envoyer ni recevoir de fonds. Il doit être réactivé pour que les nouvelles tentatives puissent aboutir. |
| `partner_high_risk_customer` | `partner_high_risk_customer` | Le prestataire de services de paiement considère que ce client présente un risque élevé. | Le prestataire de services de paiement considère que ce client présente un risque élevé. |
| `compliance_violation` | `compliance_violation` | Le paiement enfreint les conditions d’utilisation du service, le règlement du programme ou les lois en vigueur. | Le paiement enfreint les Conditions d’utilisation du service, le règlement du programme ou les lois en vigueur. Toute autre tentative échouera. |
| `payment_disputed` | `payment_disputed` | Ce paiement fait l’objet d’un litige. | Ce paiement fait l’objet d’un litige. Les nouvelles tentatives pourront aboutir si l’entreprise remporte le litige. |
| `invalid_authorization` | `invalid_authorization` | L’autorisation n’est pas valide ou a été révoquée. | Le paiement n’a pas reçu d’autorisation, ou celle-ci a été révoquée. Toute autre tentative échouera. |
| `invalid_payment_information` | `invalid_payment_information` | Ce paiement contient des informations non valides. | Ce paiement contient des informations non valides. Toute autre tentative échouera. |
| `partner_payment_not_found` | `partner_payment_not_found` | Le prestataire de services de paiement ne parvient pas à trouver ce paiement. | Le prestataire de services de paiement ne parvient pas à trouver ce paiement. |
| `expired_payment_information` | `expired_payment_information` | L’instrument de paiement sous-jacent a expiré. | Les informations de paiement ont expiré. Une nouvelle tentative peut réussir une fois que le client a mis à jour ses informations de paiement. |
| `duplicate_transaction` | `partner_duplicate_transaction` | Une transaction comportant des informations identiques a été soumise récemment. | Une transaction comportant des informations identiques a été soumise récemment au partenaire. |
| `recurring_not_supported_by_bank` | `recurring_not_supported_by_bank` | La banque du client ne prend pas en charge les paiements récurrents pour ce moyen de paiement. | La banque du client ne prend pas en charge les paiements récurrents pour ce moyen de paiement. Invitez le client à sélectionner une banque compatible avec les paiements récurrents. |
| `partner_action_not_supported` | `partner_action_not_supported` | Le prestataire de paiement ne prend pas en charge cette action. | Le prestataire de paiement ne prend pas en charge cette action. Toute autre tentative échouera. |
| `lost_or_stolen_card` | `lost_or_stolen_card` | Le paiement a été refusé car la carte bancaire a été déclarée perdue ou volée. | N’indiquez pas le motif précis du refus de paiement au client. Présentez-le plutôt comme un refus générique, `partner_generic_decline`. |
| `card_already_activated` | `card_already_activated` | La carte bancaire a déjà été activée. | La carte bancaire a déjà été activée. Toute autre tentative échouera. |
| `invalid_track_data` | `invalid_track_data` | Les données de la carte bancaire sont incorrectes. | Les données de la carte bancaire ne sont pas correctes. Le client doit contacter l’émetteur de sa carte pour vérifier qu’elle fonctionne correctement. |