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

# Refus de carte et règles de risque

> Pourquoi les transactions par Whop Card sont refusées et quelles règles de risque s'appliquent lors de l'autorisation

Les Whop Cards appliquent des règles système, des limites de carte et des contrôles de risque en temps réel à chaque autorisation. Cette page explique pourquoi Whop peut refuser une transaction par carte, quels codes d'autorisation vous pouvez rencontrer et quelles règles de risque automatiques sont appliquées.

## Motifs courants de refus de transaction

Les refus peuvent survenir pour plusieurs raisons, notamment des règles système, des limites de carte et des contrôles de risque en temps réel. Lorsque Whop refuse une transaction, il enregistre un motif avec la transaction.

Cette liste n'est pas exhaustive. Certains refus proviennent du réseau de cartes ou du processeur plutôt que d'une règle de Whop, et ceux-ci ont la priorité. Dans ces cas, le motif peut être une description générique comme `restricted card`, ou Whop peut ne recevoir aucun motif.

## Que faire en cas de refus

De nombreux refus correspondent à des situations sur lesquelles vous pouvez agir. Le tableau suivant associe les motifs courants à leur cause et à l'action à entreprendre :

| Motif du refus | Signification | Ce que vous pouvez faire |
| - | - | - |
| `card spending limit exceeded` | La transaction a atteint la limite de dépenses configurée pour la carte | Vérifiez ou ajustez les contrôles de dépenses de la carte |
| `account credit limit exceeded` | Solde disponible insuffisant pour la transaction | Ajoutez des fonds à votre solde avant de réessayer |
| `card locked` / `card canceled` / `card not activated` | La carte n'est pas active | Gérez le statut de la carte (activez-la ou déverrouillez-la selon le cas) |
| `invalid pin attempt limit exceeded` | Trop de tentatives de code PIN incorrectes. Le système verrouille automatiquement la carte | Déverrouillez la carte pour rétablir l'accès, ou contactez le support Whop |
| `transaction declined by risk rules` | Le moteur d'évaluation du risque de fraude a refusé l'autorisation | Contactez le support Whop si vous pensez que le moteur a refusé une transaction par erreur |
| `restricted country` | La transaction provient d'une juridiction soumise à restrictions ou à sanctions | Ces refus découlent de la politique de conformité et vous ne pouvez pas les contourner |

Quelques autres paramètres par défaut à noter :

* Les retraits aux distributeurs automatiques de billets sont indisponibles par défaut.
* Whop restreint par défaut les quasi-espèces et certaines catégories de transfert d'argent.
* 3D Secure (3DS) : un échec de la vérification 3DS peut entraîner un refus.
* Address Verification Service (<abbr title="Address Verification Service">AVS</abbr>) : Whop prend en charge ce service et vous permet de le configurer par carte. Des incohérences peuvent contribuer à un refus.

## Codes d'autorisation et leur signification

Les Whop Cards utilisent des codes d'autorisation spécifiques pour classer le contexte et le statut de chaque transaction. Voici quelques codes couramment rencontrés :

| Code | Signification |
| - | - |
| 00 | Présentation normale |
| 01 | Client non présent |
| 02 | Terminal sans surveillance - le terminal peut retenir la carte |
| 03 | Marchand suspect |
| 05 | Client présent, carte non présente |
| 06 | Demande pré-autorisée |
| 07 | Appareil téléphonique requis |
| 08 | Commande par courrier/téléphone |
| 09 | Alerte de sécurité <abbr title="point de vente">POS</abbr> |
| 10 | Identité du client vérifiée |
| 11 | Activité suspecte |
| 12 | Raisons de sécurité |
| 13 | Nouvelle présentation de l'élément |
| 14 | Terminal de service public |
| 15 | Terminal du client |
| 16 | Terminal administratif |
| 17 | Élément retourné |
| 18 | Pas de chèque dans l'enveloppe - retour |
| 19 | Dépôt déséquilibré - retour |
| 20 | Paiement déséquilibré - retour |
| 21 | Annulation manuelle |
| 22 | Erreur du terminal - comptabilisée |
| 23 | Erreur du terminal - non comptabilisée |
| 24 | Dépôt déséquilibré - appliquer |
| 25 | Paiement déséquilibré - appliquer |
| 26 | Erreur de retrait - annulée |
| 27 | Terminal sans surveillance - le terminal ne peut pas retenir la carte |
| 51 | Demande de vérification du numéro de compte |
| 59 | Demande de commerce électronique via un réseau public |
| 71 | Carte présente, bande magnétique illisible (États-Unis uniquement) |

## Règles de risque appliquées lors de l'autorisation

Les Whop Cards appliquent des règles automatiques de détection des risques afin d'empêcher les transactions à haut risque ou suspectes. Chaque règle comprend une fenêtre de temps et un seuil de déclenchement :

| Nom de la règle | Description | Fenêtre de temps | Seuil de déclenchement |
| - | - | - | - |
| Blocked Country | Refuser toutes les transactions dans les pays bloqués | Immédiat | N/A |
| High Risk <abbr title="code de catégorie de marchand">MCC</abbr> | Refuser les transactions associées à des codes de catégorie de marchand à haut risque | Immédiat | N/A |
| High Risk E-commerce | Refuser les transactions auprès de marchands en ligne signalés | Immédiat | N/A |
| Card-present Rapid Transaction | Empêcher une rafale de transactions avec carte présente lorsque quelqu'un tente plus de 2 transactions en 5 minutes | 5 minutes | 2 transactions |
| Card Velocity | Cartes grand public uniquement. Refuser une rafale de transactions sur la même carte | 15 minutes / 1 heure | 40 / 60 transactions |
| Card-MCC Velocity | Cartes grand public uniquement. Refuser une rafale de transactions sur la même carte au sein d'un même <abbr title="code de catégorie de marchand">MCC</abbr> | 15 minutes / 1 heure | 35 / 50 transactions |
| Card Count and Amount Velocity | Cartes grand public uniquement. Refuser lorsque la même carte dépasse à la fois le nombre de transactions et le montant total sur la fenêtre | 15 minutes / 1 heure / 24 heures | 30 et 2 000 $/ 45 et 3 000$ / 300 et 15 000 \$ |
| Card-MCC Count and Amount Velocity | Cartes grand public uniquement. Refuser lorsque la même carte dépasse à la fois le nombre de transactions et le montant total au sein d'un même <abbr title="code de catégorie de marchand">MCC</abbr> sur la fenêtre | 15 minutes / 1 heure / 24 heures | 25 et 2 000 $/ 40 et 3 000$ / 250 et 12 000 \$ |
| Card-Merchant Daily Velocity | Refuser les transactions entre une même carte et un même marchand lorsque plus de 200 transactions ont lieu en 24 heures. Apparaît sous la forme `transaction declined by risk rules` | 24 heures | 200 transactions |
| Card-Merchant Authentication 15min Burst Velocity | Refuser les prélèvements de blocage temporaire (authentification) de Google lorsque la même carte et le même marchand dépassent 20 transactions sur une fenêtre de 14 minutes | 14 minutes | 20 transactions |
| <abbr title="distributeur automatique de carburant">AFD</abbr> Auth Hold | Placer les autorisations de carburant (<abbr title="code de catégorie de marchand">MCC</abbr> 5542) inférieures à 175 \$ en blocage de sur-autorisation au lieu de les refuser | Immédiat | 175 <abbr title="dollars américains">USD</abbr> |
| Gaming Limit | Refuser une transaction unique de jeu vidéo ou de biens numériques (<abbr title="code de catégorie de marchand">MCC</abbr> 5816/7994) dépassant 2 000 \$ | Immédiat | 2 000 <abbr title="dollars américains">USD</abbr> |
| Gaming Velocity | Refuser au-delà de 25 transactions de jeu sur une période de 2 jours | 2 jours | 25 transactions |
| Ad Services Limit | Refuser une transaction unique de services publicitaires (<abbr title="code de catégorie de marchand">MCC</abbr> 7311) dépassant 10 000 \$ | Immédiat | 10 000 <abbr title="dollars américains">USD</abbr> |
| Ad Services Velocity | Refuser au-delà de 40 transactions de services publicitaires (<abbr title="code de catégorie de marchand">MCC</abbr> 7311) en 24 heures | 24 heures | 40 transactions |
| Adult Content Limit | Refuser une transaction unique de contenu pour adultes (<abbr title="code de catégorie de marchand">MCC</abbr> 5967) dépassant 200 \$ | Immédiat | 200 <abbr title="dollars américains">USD</abbr> |
| Adult Content Velocity | Refuser au-delà de 10 transactions de contenu pour adultes (<abbr title="code de catégorie de marchand">MCC</abbr> 5967) en 24 heures | 24 heures | 10 transactions |
| <abbr title="cryptogramme visuel">CVV</abbr> Security | Bloquer une transaction après 4 tentatives de cryptogramme visuel incorrectes en 24 heures | 24 heures | 4 transactions |
| <abbr title="distributeur automatique de billets">ATM</abbr> Withdrawal Limit | Bloquer un retrait au distributeur automatique de billets (<abbr title="code de catégorie de marchand">MCC</abbr> 6011) dépassant 250 \$ | Immédiat | 250 <abbr title="dollars américains">USD</abbr> |
| <abbr title="distributeur automatique de billets">ATM</abbr> Withdrawal Velocity | Bloquer un retrait au distributeur automatique de billets (<abbr title="code de catégorie de marchand">MCC</abbr> 6011) lorsque quelqu'un tente plus de 3 transactions en 24 heures | 24 heures | 3 transactions |
| High Velocity – EA Sports FC | Refuser lorsque plus de 5 transactions avec la même carte ont lieu chez Google EA Sports FC en 24 heures | 24 heures | 5 transactions |
| High Velocity – Discord | Refuser lorsque plus de 10 transactions avec la même carte ont lieu chez des marchands Discord sur une période de 7 jours | 7 jours | 10 transactions |
| High Velocity – Free Fire MAX | Refuser lorsque plus de 10 transactions avec la même carte ont lieu chez Google Free Fire MAX en 24 heures | 24 heures | 10 transactions |

Le tableau indique les seuils par défaut. Whop peut les modifier au fil du temps à mesure que les règles de risque évoluent.

En complément de ces règles, un moteur d'évaluation du risque de fraude note les transactions. Whop refuse les autorisations à haut risque avec `transaction_declined_by_risk_rules`.

## Catégories et marchands bloqués

Les Whop Cards bloquent par défaut certains codes de catégorie de marchand et certains marchands spécifiques. Consultez [Catégories et marchands bloqués](https://docs.whop.com/fr/whop-finance/blocked-categories-and-merchants.md) pour les listes complètes.

## Étapes suivantes

> [card] [Catégories et marchands bloqués](https://docs.whop.com/fr/whop-finance/blocked-categories-and-merchants.md)
>
> Consultez les catégories de marchands et les marchands que les Whop Cards bloquent par défaut

> [card] [Whop Cards](https://docs.whop.com/fr/whop-finance/cards.md)
>
> Dépensez votre solde instantanément et gagnez du cashback chez certains marchands


## Related topics

- [Catégories et marchands bloqués](https://docs.whop.com/fr/whop-finance/blocked-categories-and-merchants.md)
- [Whop Cards](https://docs.whop.com/fr/whop-finance/cards.md)
- [Gérer les refus de paiement et les échecs de renouvellement](https://docs.whop.com/fr/payments/payment-declines.md)
