> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Gérer les refus de paiement et les échecs de renouvellement

> La signification de chaque code de refus, la manière dont Whop retente les paiements échoués et marque les abonnements comme impayés, et comment aider les clients à mettre à jour leur carte et à réessayer.

Découvrez les causes des refus de paiement, ce que fait Whop pour les récupérer et comment vous ou vos clients pouvez résoudre les paiements refusés.

## Motifs et messages de refus spécifiques

Lorsque le processeur de paiement refuse un paiement, vous pouvez recevoir l'un de ces codes de refus spécifiques. Voici la signification de chacun et comment résoudre le problème :

| Motif du refus | Explication |
| - | - |
| `insufficient_funds` | Votre carte ne dispose pas de fonds suffisants pour effectuer cet achat. Veuillez utiliser un autre moyen de paiement ou vérifier que votre compte dispose de fonds suffisants. |
| `lost_card` | L'émetteur de la carte a refusé ce paiement car le titulaire a déclaré la carte perdue. Veuillez utiliser une autre carte pour finaliser votre achat. |
| `stolen_card` | L'émetteur de la carte a refusé ce paiement car le titulaire a déclaré la carte volée. Veuillez utiliser une autre carte pour finaliser votre achat. |
| `expired_card` | Votre carte a expiré. Veuillez vérifier la date d'expiration et réessayer, ou utiliser une autre carte. |
| `suspected_fraud` | Des contrôles de sécurité ont empêché le paiement. Veuillez contacter votre banque pour plus d'informations ou essayer un autre moyen de paiement. |
| `invalid_card_number` | Le numéro de carte est incorrect. Veuillez vérifier le numéro à 16 chiffres de votre carte et réessayer. |
| `invalid_cvc` | Le code de vérification de la carte (<abbr title="code de vérification de la carte">CVC</abbr>) est incorrect. Veuillez vérifier le code à trois ou quatre chiffres au dos de votre carte (ou au recto pour Amex) et réessayer. |
| `invalid_cvc_or_expiration` | Le code de vérification de la carte (<abbr title="code de vérification de la carte">CVC</abbr>) ou la date d'expiration est incorrect. Veuillez vérifier à la fois le code de sécurité à trois ou quatre chiffres et la date d'expiration au format <abbr title="mois/année">MM/YY</abbr>. |
| `incorrect_pin` | Le code personnel (<abbr title="numéro d'identification personnel">PIN</abbr>) que vous avez saisi est incorrect. Veuillez réessayer avec le bon code. Ce refus ne s'applique qu'aux paiements effectués avec un lecteur de carte. |
| `authentication_required` | Ce paiement nécessite une vérification supplémentaire. Votre banque peut ouvrir son site web ou envoyer un SMS pour confirmer cette transaction. Veuillez effectuer la vérification pour continuer. |
| `card_not_supported` | Cette carte ne prend pas en charge ce type d'achat. Veuillez essayer une autre carte de crédit ou de débit. |
| `currency_not_supported` | Votre carte ne prend pas en charge les paiements dans cette devise. Veuillez utiliser une autre carte ou contacter votre banque au sujet des transactions internationales. |
| `duplicate_transaction` | Une transaction du même montant avec la même carte vient d'être traitée. Veuillez vérifier vos e-mails pour la confirmation. Si vous ne l'avez pas reçue, veuillez patienter quelques minutes avant de réessayer. |
| `generic_decline` | L'émetteur de votre carte a refusé le paiement. Veuillez essayer : 1) d'utiliser une autre carte, 2) de contacter votre banque, ou 3) de vérifier que vos informations de facturation sont correctes. |
| `invalid_account` | Cette carte ou le compte associé n'est pas valide. Veuillez utiliser une autre carte ou contacter votre banque pour obtenir de l'aide. |
| `invalid_amount` | Le montant du paiement dépasse la limite de votre carte. Veuillez essayer un montant inférieur ou utiliser un autre moyen de paiement. |
| `processing_error` | Un problème temporaire a interrompu le traitement du paiement. Veuillez patienter un instant et réessayer, ou utiliser une autre carte. |
| `restricted_card` | Votre banque applique à cette carte des restrictions qui empêchent ce paiement. Veuillez contacter votre banque pour autoriser les achats internationaux ou en ligne, ou utiliser une autre carte. |
| `card_velocity_exceeded` | Vous avez dépassé la limite de transactions ou le solde disponible de votre carte. Veuillez essayer un montant inférieur ou utiliser une autre carte. |
| `contact_issuer` | Veuillez contacter l'émetteur de votre carte pour plus d'informations sur ce refus. Appelez le numéro indiqué au dos de votre carte. |
| `bank_declined` | Votre banque a refusé cette transaction. Veuillez essayer une autre carte ou contacter votre banque. |
| `regulatory_blocked` | Des restrictions réglementaires dans votre région empêchent cette transaction. Veuillez essayer un autre moyen de paiement ou contacter le support pour connaître les alternatives. |
| `transaction_not_permitted` | L'émetteur de votre carte n'autorise pas ce type de transaction. Veuillez utiliser une autre carte ou contacter votre banque pour autoriser ce type de transaction. |
| `card_type_not_supported` | Le processeur de paiement ne prend pas en charge ce type de carte. Veuillez essayer une autre carte. |
| `issuer_not_found` | L'émetteur de la carte a refusé le paiement en raison d'informations de carte ou de facturation incorrectes. Veuillez vérifier votre numéro de carte, la date d'expiration et l'adresse de facturation, puis réessayer. |
| `closed_account` | Le compte de la carte n'est plus ouvert. Veuillez utiliser une autre carte pour finaliser votre achat. |
| `issuer_unavailable` | Le processeur de paiement n'a pas pu joindre l'émetteur de votre carte pour autoriser ce paiement. Ce problème est généralement temporaire. Veuillez réessayer dans quelques minutes ou utiliser une autre carte. |
| `invalid_zip` | Le code postal de facturation ne correspond pas aux informations de votre carte. Veuillez saisir le code postal associé à l'adresse de facturation de votre carte. |
| `invalid_expiry_month` | Le mois d'expiration n'est pas valide. Veuillez saisir un mois valide (01-12) et réessayer. |
| `invalid_expiry_year` | L'année d'expiration n'est pas valide. Veuillez saisir une année valide à 2 ou 4 chiffres (par ex. 25 ou 2025) et réessayer. |
| `invalid_expiry` | La date d'expiration n'est pas valide. Veuillez saisir une date valide au format <abbr title="mois/année">MM/YY</abbr> et vérifier que la carte n'a pas expiré. |
| `invalid_transaction` | La banque émettrice a refusé cette transaction. Cela peut être dû à un numéro de carte incorrect, une carte expirée, une carte non valide, une date d'expiration erronée, une adresse de facturation ou un code postal ne correspondant pas, ou plusieurs tentatives de transaction rapprochées. Veuillez vérifier les informations de votre carte et réessayer. |
| `cannot_authorize` | Le processeur de paiement n'a pas pu autoriser ce paiement. Veuillez essayer une autre carte ou contacter votre banque pour plus d'informations. |
| `pin_required` | Cette carte nécessite un code personnel (<abbr title="numéro d'identification personnel">PIN</abbr>) pour la transaction. Veuillez utiliser un lecteur de carte compatible ou essayer une autre carte. |
| `pin_try_exceeded` | Vous avez saisi un code personnel (<abbr title="numéro d'identification personnel">PIN</abbr>) incorrect trop de fois. La carte est temporairement bloquée par mesure de sécurité. Veuillez contacter votre banque ou utiliser une autre carte. |
| `high_risk` | Des problèmes de sécurité ont empêché le paiement. Veuillez essayer une autre carte ou contacter le support pour obtenir de l'aide. |
| `test_mode_decline` | Il semble s'agir d'un numéro de carte de test. Veuillez utiliser une véritable carte de crédit ou de débit pour finaliser votre achat. |
| `merchant_blacklist` | Des contrôles de sécurité ont bloqué ce paiement. Veuillez essayer une autre carte ou contacter le support pour obtenir de l'aide. |
| `reenter_transaction` | Votre banque n'a pas pu traiter ce paiement. Veuillez réessayer, utiliser une autre carte ou contacter votre banque pour plus d'informations. |
| `invalid_pin` | Le code personnel (<abbr title="numéro d'identification personnel">PIN</abbr>) que vous avez saisi est incorrect. Veuillez réessayer avec le bon code pour cette carte. |
| `pin_required_as` | Cette carte nécessite un code personnel (<abbr title="numéro d'identification personnel">PIN</abbr>) pour la transaction. Veuillez utiliser un lecteur de carte compatible ou essayer une autre carte. |
| `withdrawal_count_limit_exceeded` | Vous avez dépassé la limite quotidienne de transactions ou le solde disponible de votre carte. Veuillez réessayer demain ou utiliser une autre carte. |
| `invalid_country` | Le pays de facturation ne correspond pas aux informations de votre carte. Veuillez vérifier le pays de votre adresse de facturation et réessayer. |
| `issuer_error` | Votre banque a détecté un problème mais n'a pas pu l'identifier. Veuillez réessayer dans quelques minutes ou contacter directement votre banque pour obtenir de l'aide. |

## Que se passe-t-il après un refus de paiement

Lorsque le paiement d'un client est refusé ou échoue, Whop prend plusieurs mesures pour tenter de récupérer le paiement :

* **Le statut de l'abonnement passe à Past due** : le paiement nécessite une attention particulière, mais ce statut ne coupe pas immédiatement l'accès
  * Accédez à **Dashboard** > **Payments**, sélectionnez **Status**, puis sélectionnez uniquement **Past due**
* **Whop envoie un e-mail au client** : vos clients reçoivent des e-mails les invitant à mettre à jour leurs informations de paiement. La page [Paiements d'abonnement échoués](https://docs.whop.com/fr/payments-and-billing/payment-issues/troubleshoot-failed-payments.md) explique ce qu'ils peuvent faire
* **Whop retente le paiement** : Whop retente automatiquement le prélèvement sur une période de cinq jours
* **L'accès peut être temporairement suspendu** : selon vos paramètres, votre client peut perdre l'accès à votre whop jusqu'à ce que le paiement aboutisse
  * Accédez à **Dashboard** > **Settings** > **Checkout**
  * Choisissez si les membres conservent l'accès avec **Access while past due**
* **Whop annule l'abonnement** : si le paiement échoue toujours après cinq jours, Whop annule automatiquement l'abonnement

## Ce que vous pouvez faire pour résoudre un paiement refusé

Après un refus de paiement, vous pouvez aider le client à mettre à jour son moyen de paiement et retenter manuellement le paiement depuis votre tableau de bord.

**Étape 1 : demandez au client de mettre à jour son moyen de paiement**

* Contactez le client pour confirmer qu'il dispose de fonds suffisants et d'un moyen de paiement fonctionnel
* Pour mettre à jour son moyen de paiement, demandez-lui de suivre ces étapes :
  1. Accédez à [https://whop.com/@me/settings/memberships](https://whop.com/@me/settings/memberships)
  2. Sélectionnez l'abonnement inactif
  3. Sélectionnez **Update payment method**
  4. Ajoutez les informations de la nouvelle carte et enregistrez

**Étape 2 : retentez manuellement le paiement depuis votre tableau de bord**

1. Accédez à **Dashboard** > **Payments**
2. Sélectionnez **Status** puis sélectionnez uniquement **Failed**
3. Sélectionnez le paiement échoué
4. Sélectionnez **Retry payment**

Lorsque le paiement est traité avec succès, Whop rétablit automatiquement l'accès du client.


## Related topics

- [Gérer les taux de litiges](https://docs.whop.com/fr/trust-and-safety/account-health/managing-dispute-rates.md)
- [Gérer les utilisateurs](https://docs.whop.com/fr/manage-your-business/manage-payments/manage-users.md)
- [Explication des codes de refus de paiement](https://docs.whop.com/fr/payments-and-billing/payment-issues/payment-decline-reasons.md)
