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

# Kaartweigeringen en risicoregels

> Waarom transacties met een Whop Card worden geweigerd en welke risicoregels tijdens de autorisatie worden toegepast

Whop Cards passen systeemregels, kaartlimieten en realtime risicocontroles toe op elke autorisatie. Deze pagina legt uit waarom Whop een kaarttransactie kan weigeren, welke autorisatiecodes je kunt tegenkomen en welke automatische risicoregels worden gehandhaafd.

## Veelvoorkomende redenen voor weigering van transacties

Weigeringen kunnen om verschillende redenen optreden, waaronder systeemregels, kaartlimieten en realtime risicocontroles. Wanneer Whop een transactie weigert, legt het een reden vast bij de transactie.

Deze lijst is niet uitputtend. Sommige weigeringen komen van het kaartnetwerk of de verwerker in plaats van een regel van Whop, en die hebben voorrang. In die gevallen kan de reden een algemene omschrijving zijn, zoals `restricted card`, of ontvangt Whop mogelijk geen reden.

## Wat je kunt doen bij een weigering

Veel weigeringen zijn uitkomsten waar je iets aan kunt doen. De volgende tabel koppelt veelvoorkomende redenen aan hun oorzaak en je volgende stap:

| Reden voor weigering | Wat het betekent | Wat je kunt doen |
| - | - | - |
| `card spending limit exceeded` | De transactie heeft de ingestelde bestedingslimiet van de kaart bereikt | Bekijk of wijzig de bestedingsinstellingen van de kaart |
| `account credit limit exceeded` | Onvoldoende beschikbaar saldo voor de transactie | Voeg geld toe aan je saldo voordat je het opnieuw probeert |
| `card locked` / `card canceled` / `card not activated` | De kaart is niet actief | Beheer de status van de kaart (activeer of ontgrendel waar nodig) |
| `invalid pin attempt limit exceeded` | Te veel onjuiste pogingen met de pincode. Het systeem vergrendelt de kaart automatisch | Ontgrendel de kaart om de toegang te herstellen, of neem contact op met Whop support |
| `transaction declined by risk rules` | Het systeem voor fraudescores heeft de autorisatie geweigerd | Neem contact op met Whop support als je denkt dat het systeem een transactie ten onrechte heeft geweigerd |
| `restricted country` | De transactie is afkomstig uit een beperkt of gesanctioneerd rechtsgebied | Deze weigeringen volgen het compliancebeleid en je kunt ze niet omzeilen |

Een paar aanvullende standaardinstellingen om rekening mee te houden:

* Geldopnames bij geldautomaten zijn standaard niet beschikbaar.
* Whop beperkt standaard quasi-contant geld en bepaalde categorieën voor geldovermakingen.
* 3D Secure (3DS): een mislukte 3DS-verificatie kan tot een weigering leiden.
* Address Verification Service (<abbr title="Address Verification Service">AVS</abbr>): Whop ondersteunt deze dienst en laat je die per kaart configureren. Afwijkingen kunnen bijdragen aan een weigering.

## Autorisatiecodes en hun betekenis

Whop Cards gebruiken specifieke autorisatiecodes om de context en status van elke transactie te classificeren. Dit zijn enkele veelvoorkomende codes:

| Code | Betekenis |
| - | - |
| 00 | Normale presentatie |
| 01 | Klant niet aanwezig |
| 02 | Onbemande terminal - terminal kan kaart innemen |
| 03 | Handelaar verdacht |
| 05 | Klant aanwezig, kaart niet aanwezig |
| 06 | Vooraf geautoriseerd verzoek |
| 07 | Telefoonapparaat vereist |
| 08 | Post-/telefonische bestelling |
| 09 | Beveiligingswaarschuwing <abbr title="point of sale">POS</abbr> |
| 10 | Identiteit klant geverifieerd |
| 11 | Verdachte activiteit |
| 12 | Veiligheidsredenen |
| 13 | Herpresentatie van item |
| 14 | Terminal van openbaar nutsbedrijf |
| 15 | Terminal van klant |
| 16 | Administratieve terminal |
| 17 | Geretourneerd item |
| 18 | Geen cheque in envelop - retour |
| 19 | Storting niet in balans - retour |
| 20 | Betaling niet in balans - retour |
| 21 | Handmatige terugboeking |
| 22 | Terminalfout - geteld |
| 23 | Terminalfout - niet geteld |
| 24 | Storting niet in balans - toepassen |
| 25 | Betaling niet in balans - toepassen |
| 26 | Opnamefout - teruggeboekt |
| 27 | Onbemande terminal - terminal kan kaart niet innemen |
| 51 | Verzoek om verificatie van rekeningnummer |
| 59 | E-commerceverzoek via openbaar netwerk |
| 71 | Kaart aanwezig, magneetstrip onleesbaar (alleen VS) |

## Risicoregels die tijdens de autorisatie worden gehandhaafd

Whop Cards handhaven automatische regels voor risicodetectie om risicovolle of verdachte transacties te voorkomen. Elke regel heeft een tijdvenster en een triggerdrempel:

| Naam regel | Beschrijving | Tijdvenster | Triggerdrempel |
| - | - | - | - |
| Blocked Country | Weiger alle transacties in geblokkeerde landen | Direct | N.v.t. |
| High Risk <abbr title="merchant category code">MCC</abbr> | Weiger transacties met risicovolle merchant category codes | Direct | N.v.t. |
| High Risk E-commerce | Weiger transacties met gemarkeerde online handelaren | Direct | N.v.t. |
| Card-present Rapid Transaction | Voorkom een reeks transacties met fysieke kaart wanneer iemand meer dan 2 transacties binnen 5 minuten probeert | 5 minuten | 2 transacties |
| Card Velocity | Alleen consumentenkaarten. Weiger een reeks transacties op dezelfde kaart | 15 minuten / 1 uur | 40 / 60 transacties |
| Card-MCC Velocity | Alleen consumentenkaarten. Weiger een reeks transacties op dezelfde kaart binnen één <abbr title="merchant category code">MCC</abbr> | 15 minuten / 1 uur | 35 / 50 transacties |
| Card Count and Amount Velocity | Alleen consumentenkaarten. Weiger wanneer dezelfde kaart binnen het venster zowel het aantal transacties als het totaalbedrag overschrijdt | 15 minuten / 1 uur / 24 uur | 30 en $2.000 / 45 en $3.000 / 300 en \$15.000 |
| Card-MCC Count and Amount Velocity | Alleen consumentenkaarten. Weiger wanneer dezelfde kaart binnen het venster zowel het aantal transacties als het totaalbedrag binnen één <abbr title="merchant category code">MCC</abbr> overschrijdt | 15 minuten / 1 uur / 24 uur | 25 en $2.000 / 40 en $3.000 / 250 en \$12.000 |
| Card-Merchant Daily Velocity | Weiger transacties tussen dezelfde kaart en handelaar wanneer er meer dan 200 transacties binnen 24 uur plaatsvinden. Verschijnt als `transaction declined by risk rules` | 24 uur | 200 transacties |
| Card-Merchant Authentication 15min Burst Velocity | Weiger tijdelijke blokkeringen (authenticatie) van Google wanneer dezelfde kaart en handelaar meer dan 20 transacties binnen een venster van 14 minuten overschrijden | 14 minuten | 20 transacties |
| <abbr title="automated fuel dispenser">AFD</abbr> Auth Hold | Plaats brandstofautorisaties (<abbr title="merchant category code">MCC</abbr> 5542) onder \$175 in een over-autorisatieblokkering in plaats van ze te weigeren | Direct | \$175 <abbr title="United States dollars">USD</abbr> |
| Gaming Limit | Weiger een enkele transactie voor videogames of digitale goederen (<abbr title="merchant category code">MCC</abbr> 5816/7994) van meer dan \$2.000 | Direct | \$2.000 <abbr title="United States dollars">USD</abbr> |
| Gaming Velocity | Weiger bij meer dan 25 gamingtransacties binnen 2 dagen | 2 dagen | 25 transacties |
| Ad Services Limit | Weiger een enkele transactie voor advertentiediensten (<abbr title="merchant category code">MCC</abbr> 7311) van meer dan \$10.000 | Direct | \$10.000 <abbr title="United States dollars">USD</abbr> |
| Ad Services Velocity | Weiger meer dan 40 transacties voor advertentiediensten (<abbr title="merchant category code">MCC</abbr> 7311) binnen 24 uur | 24 uur | 40 transacties |
| Adult Content Limit | Weiger een enkele transactie voor content voor volwassenen (<abbr title="merchant category code">MCC</abbr> 5967) van meer dan \$200 | Direct | \$200 <abbr title="United States dollars">USD</abbr> |
| Adult Content Velocity | Weiger meer dan 10 transacties voor content voor volwassenen (<abbr title="merchant category code">MCC</abbr> 5967) binnen 24 uur | 24 uur | 10 transacties |
| <abbr title="card verification value">CVV</abbr> Security | Blokkeer een transactie na 4 onjuiste pogingen met de kaartverificatiewaarde binnen 24 uur | 24 uur | 4 transacties |
| <abbr title="automated teller machine">ATM</abbr> Withdrawal Limit | Blokkeer een geldopname bij een geldautomaat (<abbr title="merchant category code">MCC</abbr> 6011) van meer dan \$250 | Direct | \$250 <abbr title="United States dollars">USD</abbr> |
| <abbr title="automated teller machine">ATM</abbr> Withdrawal Velocity | Blokkeer een geldopname bij een geldautomaat (<abbr title="merchant category code">MCC</abbr> 6011) nadat iemand meer dan 3 transacties binnen 24 uur probeert | 24 uur | 3 transacties |
| High Velocity – EA Sports FC | Weiger wanneer er binnen 24 uur meer dan 5 transacties met dezelfde kaart bij Google EA Sports FC plaatsvinden | 24 uur | 5 transacties |
| High Velocity – Discord | Weiger wanneer er binnen 7 dagen meer dan 10 transacties met dezelfde kaart bij Discord-handelaren plaatsvinden | 7 dagen | 10 transacties |
| High Velocity – Free Fire MAX | Weiger wanneer er binnen 24 uur meer dan 10 transacties met dezelfde kaart bij Google Free Fire MAX plaatsvinden | 24 uur | 10 transacties |

De tabel toont standaarddrempels. Whop kan deze in de loop van de tijd bijwerken wanneer risicoregels veranderen.

Naast deze regels kent een systeem voor frauderisico scores toe aan transacties. Whop weigert risicovolle autorisaties met `transaction_declined_by_risk_rules`.

## Geblokkeerde categorieën en handelaren

Whop Cards blokkeren standaard bepaalde merchant category codes en specifieke handelaren. Zie [Geblokkeerde categorieën en handelaren](https://docs.whop.com/nl/whop-finance/blocked-categories-and-merchants.md) voor de volledige lijsten.

## Volgende stappen

> [card] [Geblokkeerde categorieën en handelaren](https://docs.whop.com/nl/whop-finance/blocked-categories-and-merchants.md)
>
> Bekijk de handelaarscategorieën en handelaren die Whop Cards standaard blokkeren

> [card] [Whop Cards](https://docs.whop.com/nl/whop-finance/cards.md)
>
> Besteed je saldo direct en verdien cashback bij geselecteerde handelaren
