> ## 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.

# Santé des paiements

> Utilisez le tableau de bord Payment health pour suivre vos taux de litiges et de remboursements et voir les contrôles appliqués à votre compte.

Votre tableau de bord **Payment health** montre comment les litiges et les remboursements affectent votre compte et vos contrôles de paiement. Vous le trouverez dans votre tableau de bord sous **Payments** → **Payment health**, à l'adresse [whop.com/dashboard/payments/health](https://whop.com/dashboard/payments/health/).

## Qu'est-ce qu'un taux de litiges

Un litige (également appelé rétrofacturation ou chargeback) survient lorsqu'un client demande à sa banque d'annuler un paiement au lieu de vous demander un remboursement. Votre taux de litiges est la part de vos paiements qui se terminent par un litige.

Quelques litiges sont normaux pour toute entreprise. Le problème, c'est le taux. Les réseaux de cartes imposent à chaque marchand un taux de litiges maximal, et le seuil qui compte pour eux est de **1,5 %**. Le programme et la limite de chaque réseau figurent dans [Programmes de surveillance des litiges](https://docs.whop.com/fr/trust-and-safety/account-health/dispute-monitoring-programs.md). Restez en dessous et votre compte est en règle. Dépassez-le et il y a des conséquences pour vous et pour Whop.

## Votre taux de litiges, mesuré de deux façons

Le tableau de bord affiche votre taux de litiges selon deux modes : **30d window** et **By purchase date**. Ils répondent à des questions différentes.

* **30d window** : litiges déposés au cours des 30 derniers jours ÷ paiements encaissés au cours des 30 derniers jours.
* **By purchase date** : prend les paiements d'une période et calcule combien d'entre eux ont fait l'objet d'un litige. Litiges déposés dans les N jours suivant le paiement ÷ paiements encaissés sur la période, où N correspond au sélecteur **Disputed within 7 days**, **Disputed within 14 days** ou **Disputed within 28 days**. Le tableau de bord rattache chaque litige à la date du paiement, et non à la date de dépôt.

Par exemple, supposons que vous ayez encaissé 1 000 paiements au cours des 30 derniers jours, et que 10 litiges soient arrivés pendant cette période :

3 sur des paiements des 30 derniers jours
7 sur des paiements plus anciens

Le taux **30d window** compte les 10 litiges : 10 ÷ 1 000 = **1 %**. Le taux **By purchase date** ne compte que les 3 qui concernent les paiements de ce mois-ci : 3 ÷ 1 000 = **0,3 %** pour l'instant. Ce taux continue d'augmenter à mesure que d'autres litiges sur les paiements de ce mois arrivent.

Celui à surveiller dépend de votre situation :

* **Si vos ventes sont stables**, les deux taux sont à peu près identiques.
* **Si vous êtes en forte croissance**, le taux sur 30 jours paraît faible, car les clients n'ont pas encore eu le temps de contester vos paiements les plus récents. Surveillez plutôt le taux par date d'achat : il montre votre taux de litiges avant que le chiffre sur 30 jours ne le rattrape.

> [!NOTE]
>
> La vue par date d'achat ne compte les paiements qu'une fois leur fenêtre de
> litige entièrement écoulée. Si votre entreprise a encaissé un paiement hier,
> sa fenêtre de 28 jours n'est pas écoulée, donc la vue ne peut pas encore le prendre en compte.

## Statuts

Chaque indicateur de taux de litiges reçoit un statut : **Healthy**, **At risk** ou **Critical**. Le graphique trace les plages exactes pour chaque indicateur, et chaque onglet de moyen de paiement a les siennes : American Express, Discover et les moyens de paiement fractionné (buy now, pay later) sont soumis à des seuils différents de ceux des cartes standard. [Programmes de surveillance des litiges](https://docs.whop.com/fr/trust-and-safety/account-health/dispute-monitoring-programs.md) répertorie tous les seuils. Si votre compte n'a pas encore assez de paiements ou de litiges pour être évalué, l'indicateur affiche **Low data** à la place.

## Les contrôles appliqués à votre compte

La section **Controls** de la page répertorie les [contrôles de paiement](https://docs.whop.com/fr/trust-and-safety/account-health/controls.md) actuellement appliqués à votre compte : votre réserve, les seuils de remboursement automatique, le délai de mise en attente, les frais et la disponibilité du financement. Les examens sont effectués en continu, et les contrôles s'assouplissent ou sont levés automatiquement à mesure que votre compte se rétablit.

## Taux de remboursement

Le tableau de bord affiche également votre taux de remboursement : les remboursements effectués en proportion des paiements. Lisez-le en regard de votre taux de litiges. Un faible taux de remboursement associé à un taux de litiges élevé signifie que les clients qui voulaient récupérer leur argent se sont adressés à leur banque au lieu de venir vers vous.

## Pourquoi les clients contestent

La carte **Why customers dispute** ventile vos litiges par motif. Chaque motif indique une solution :

| Motif | Ce que dit le client | La solution |
| - | - | - |
| **Fraudulent** | « Je ne reconnais pas ce prélèvement » | Utilisez un libellé de relevé bancaire clair et annoncez les renouvellements dès le départ |
| **Not received** | « Ma commande n'est jamais arrivée » | Ajoutez un suivi et donnez des délais de livraison honnêtes |
| **Subscription canceled** | « J'ai résilié mais j'ai quand même été prélevé » | Facilitez la résiliation et appliquez-la rapidement |
| **Product unacceptable** | « Ce n'est pas ce qu'on m'avait promis » | Faites correspondre votre vitrine à ce que vous livrez réellement |
| **Credit not processed** | « On m'avait promis un remboursement et je ne l'ai jamais reçu » | Effectuez rapidement les remboursements dus |

> [!TIP]
>
> Si un motif domine le graphique, commencez par celui-ci. Corriger la plus
> grande part fait le plus baisser votre taux.

## Étapes suivantes

> [card] [Programmes de surveillance des litiges](https://docs.whop.com/fr/trust-and-safety/account-health/dispute-monitoring-programs.md)
>
> Le programme de chaque réseau de cartes, sa manière de compter les litiges et sa limite.

> [card] [Contrôles de paiement](https://docs.whop.com/fr/trust-and-safety/account-health/controls.md)
>
> Ce que fait chaque contrôle appliqué à votre compte et comment les contrôles sont levés.

> [card] [Gérer les taux de litiges](https://docs.whop.com/fr/trust-and-safety/account-health/managing-dispute-rates.md)
>
> Les mesures concrètes qui font baisser un taux de litiges.


## Related topics

- [Contrôles de paiement](https://docs.whop.com/fr/trust-and-safety/account-health/controls.md)
- [Programmes de surveillance des litiges](https://docs.whop.com/fr/trust-and-safety/account-health/dispute-monitoring-programs.md)
- [Gérer les taux de litiges](https://docs.whop.com/fr/trust-and-safety/account-health/managing-dispute-rates.md)
