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

# Rechazos de tarjeta y reglas de riesgo

> Por qué se rechazan las transacciones con Whop Card y las reglas de riesgo que se aplican durante la autorización

Las Whop Cards aplican reglas del sistema, límites de tarjeta y comprobaciones de riesgo en tiempo real a cada autorización. Esta página explica por qué Whop puede rechazar una transacción con tarjeta, qué códigos de autorización puedes encontrar y qué reglas de riesgo automáticas aplica.

## Motivos habituales de rechazo de transacciones

Los rechazos pueden producirse por varios motivos, como reglas del sistema, límites de tarjeta y comprobaciones de riesgo en tiempo real. Cuando Whop rechaza una transacción, registra un motivo junto con la transacción.

Esta lista no es exhaustiva. Algunos rechazos se originan en la red de tarjetas o en el procesador y no en una regla de Whop, y estos tienen prioridad. En esos casos, el motivo puede ser una descripción genérica como `restricted card`, o puede que Whop no reciba ningún motivo.

## Qué puedes hacer ante un rechazo

Muchos rechazos representan resultados sobre los que puedes actuar. La siguiente tabla relaciona los motivos habituales con su causa y tu siguiente paso:

| Motivo del rechazo | Qué significa | Qué puedes hacer |
| - | - | - |
| `card spending limit exceeded` | La transacción alcanzó el límite de gasto configurado de la tarjeta | Revisa o ajusta los controles de gasto de la tarjeta |
| `account credit limit exceeded` | Saldo disponible insuficiente para la transacción | Añade fondos a tu saldo antes de volver a intentarlo |
| `card locked` / `card canceled` / `card not activated` | La tarjeta no está activa | Gestiona el estado de la tarjeta (actívala o desbloquéala según corresponda) |
| `invalid pin attempt limit exceeded` | Demasiados intentos incorrectos del número de identificación personal. El sistema bloquea automáticamente la tarjeta | Desbloquea la tarjeta para restablecer el acceso o contacta con el soporte de Whop |
| `transaction declined by risk rules` | El motor de puntuación de riesgo de fraude rechazó la autorización | Contacta con el soporte de Whop si crees que el motor rechazó una transacción por error |
| `restricted country` | La transacción se originó en una jurisdicción restringida o sancionada | Estos rechazos siguen la política de cumplimiento normativo y no puedes anularlos |

Algunos valores predeterminados adicionales que conviene tener en cuenta:

* Los retiros en cajeros automáticos no están disponibles de forma predeterminada.
* Whop restringe de forma predeterminada las categorías de cuasi efectivo y determinadas categorías de transferencia de dinero.
* 3D Secure (3DS): una verificación 3DS fallida puede dar lugar a un rechazo.
* Servicio de verificación de dirección (<abbr title="Address Verification Service">AVS</abbr>): Whop admite este servicio y te permite configurarlo por tarjeta. Las discrepancias pueden contribuir a un rechazo.

## Códigos de autorización y su significado

Las Whop Cards usan códigos de autorización específicos para clasificar el contexto y el estado de cada transacción. Estos son algunos de los códigos más habituales:

| Código | Significado |
| - | - |
| 00 | Presentación normal |
| 01 | Cliente no presente |
| 02 | Terminal desatendido: el terminal puede retener la tarjeta |
| 03 | Comerciante sospechoso |
| 05 | Cliente presente, tarjeta no presente |
| 06 | Solicitud preautorizada |
| 07 | Se requiere dispositivo telefónico |
| 08 | Pedido por correo/teléfono |
| 09 | Alerta de seguridad del <abbr title="punto de venta">POS</abbr> |
| 10 | Identidad del cliente verificada |
| 11 | Actividad sospechosa |
| 12 | Motivos de seguridad |
| 13 | Nueva presentación del artículo |
| 14 | Terminal de servicios públicos |
| 15 | Terminal del cliente |
| 16 | Terminal administrativo |
| 17 | Artículo devuelto |
| 18 | No hay cheque en el sobre: devolución |
| 19 | Depósito descuadrado: devolución |
| 20 | Pago descuadrado: devolución |
| 21 | Reversión manual |
| 22 | Error del terminal: contabilizado |
| 23 | Error del terminal: no contabilizado |
| 24 | Depósito descuadrado: aplicar |
| 25 | Pago descuadrado: aplicar |
| 26 | Error de retiro: revertido |
| 27 | Terminal desatendido: el terminal no puede retener la tarjeta |
| 51 | Solicitud de verificación del número de cuenta |
| 59 | Solicitud de comercio electrónico a través de una red pública |
| 71 | Tarjeta presente, banda magnética ilegible (solo EE. UU.) |

## Reglas de riesgo aplicadas durante la autorización

Las Whop Cards aplican reglas automáticas de detección de riesgo para evitar transacciones de alto riesgo o sospechosas. Cada regla incluye una ventana de tiempo y un umbral de activación:

| Nombre de la regla | Descripción | Ventana de tiempo | Umbral de activación |
| - | - | - | - |
| Blocked Country | Rechaza todas las transacciones en países bloqueados | Inmediato | N/A |
| High Risk <abbr title="código de categoría de comerciante">MCC</abbr> | Rechaza las transacciones con códigos de categoría de comerciante de alto riesgo | Inmediato | N/A |
| High Risk E-commerce | Rechaza las transacciones con comerciantes online señalados | Inmediato | N/A |
| Card-present Rapid Transaction | Evita una ráfaga de transacciones con tarjeta presente cuando alguien intenta más de 2 transacciones en un periodo de 5 minutos | 5 minutos | 2 transacciones |
| Card Velocity | Solo tarjetas de consumidor. Rechaza una ráfaga de transacciones con la misma tarjeta | 15 minutos / 1 hora | 40 / 60 transacciones |
| Card-MCC Velocity | Solo tarjetas de consumidor. Rechaza una ráfaga de transacciones con la misma tarjeta dentro de un mismo <abbr title="código de categoría de comerciante">MCC</abbr> | 15 minutos / 1 hora | 35 / 50 transacciones |
| Card Count and Amount Velocity | Solo tarjetas de consumidor. Rechaza cuando la misma tarjeta supera tanto el número de transacciones como el importe total en la ventana | 15 minutos / 1 hora / 24 horas | 30 y $2,000 / 45 y $3,000 / 300 y \$15,000 |
| Card-MCC Count and Amount Velocity | Solo tarjetas de consumidor. Rechaza cuando la misma tarjeta supera tanto el número de transacciones como el importe total dentro de un mismo <abbr title="código de categoría de comerciante">MCC</abbr> en la ventana | 15 minutos / 1 hora / 24 horas | 25 y $2,000 / 40 y $3,000 / 250 y \$12,000 |
| Card-Merchant Daily Velocity | Rechaza las transacciones entre la misma tarjeta y el mismo comerciante cuando se producen más de 200 transacciones en un periodo de 24 horas. Aparece como `transaction declined by risk rules` | 24 horas | 200 transacciones |
| Card-Merchant Authentication 15min Burst Velocity | Rechaza los cargos de retención temporal (autenticación) de Google cuando la misma tarjeta y el mismo comerciante superan 20 transacciones en una ventana de 14 minutos | 14 minutos | 20 transacciones |
| <abbr title="dispensador automático de combustible">AFD</abbr> Auth Hold | Coloca las autorizaciones de combustible (<abbr title="código de categoría de comerciante">MCC</abbr> 5542) inferiores a \$175 en una retención por sobreautorización en lugar de rechazarlas | Inmediato | \$175 <abbr title="dólares estadounidenses">USD</abbr> |
| Gaming Limit | Rechaza una única transacción de videojuegos o bienes digitales (<abbr title="código de categoría de comerciante">MCC</abbr> 5816/7994) que supere \$2,000 | Inmediato | \$2,000 <abbr title="dólares estadounidenses">USD</abbr> |
| Gaming Velocity | Rechaza si hay más de 25 transacciones de juegos en un periodo de 2 días | 2 días | 25 transacciones |
| Ad Services Limit | Rechaza una única transacción de servicios publicitarios (<abbr title="código de categoría de comerciante">MCC</abbr> 7311) que supere \$10,000 | Inmediato | \$10,000 <abbr title="dólares estadounidenses">USD</abbr> |
| Ad Services Velocity | Rechaza más de 40 transacciones de servicios publicitarios (<abbr title="código de categoría de comerciante">MCC</abbr> 7311) en un periodo de 24 horas | 24 horas | 40 transacciones |
| Adult Content Limit | Rechaza una única transacción de contenido para adultos (<abbr title="código de categoría de comerciante">MCC</abbr> 5967) que supere \$200 | Inmediato | \$200 <abbr title="dólares estadounidenses">USD</abbr> |
| Adult Content Velocity | Rechaza más de 10 transacciones de contenido para adultos (<abbr title="código de categoría de comerciante">MCC</abbr> 5967) en un periodo de 24 horas | 24 horas | 10 transacciones |
| <abbr title="valor de verificación de la tarjeta">CVV</abbr> Security | Bloquea una transacción tras 4 intentos incorrectos del valor de verificación de la tarjeta en un periodo de 24 horas | 24 horas | 4 transacciones |
| <abbr title="cajero automático">ATM</abbr> Withdrawal Limit | Bloquea una transacción de retiro en cajero automático (<abbr title="código de categoría de comerciante">MCC</abbr> 6011) que supere \$250 | Inmediato | \$250 <abbr title="dólares estadounidenses">USD</abbr> |
| <abbr title="cajero automático">ATM</abbr> Withdrawal Velocity | Bloquea un retiro en cajero automático (<abbr title="código de categoría de comerciante">MCC</abbr> 6011) después de que alguien intente más de 3 transacciones en un periodo de 24 horas | 24 horas | 3 transacciones |
| High Velocity – EA Sports FC | Rechaza cuando se producen más de 5 transacciones con la misma tarjeta en Google EA Sports FC en un periodo de 24 horas | 24 horas | 5 transacciones |
| High Velocity – Discord | Rechaza cuando se producen más de 10 transacciones con la misma tarjeta en comerciantes de Discord en un periodo de 7 días | 7 días | 10 transacciones |
| High Velocity – Free Fire MAX | Rechaza cuando se producen más de 10 transacciones con la misma tarjeta en Google Free Fire MAX en un periodo de 24 horas | 24 horas | 10 transacciones |

La tabla muestra los umbrales predeterminados. Whop puede actualizarlos con el tiempo a medida que cambian las reglas de riesgo.

Además de estas reglas, un motor de riesgo de fraude puntúa las transacciones. Whop rechaza las autorizaciones de alto riesgo con `transaction_declined_by_risk_rules`.

## Categorías y comerciantes bloqueados

Las Whop Cards bloquean de forma predeterminada determinados códigos de categoría de comerciante y comerciantes concretos. Consulta [Categorías y comerciantes bloqueados](https://docs.whop.com/es/whop-finance/blocked-categories-and-merchants.md) para ver las listas completas.

## Próximos pasos

> [card] [Categorías y comerciantes bloqueados](https://docs.whop.com/es/whop-finance/blocked-categories-and-merchants.md)
>
> Consulta las categorías de comerciantes y los comerciantes que las Whop Cards bloquean de forma predeterminada

> [card] [Whop Cards](https://docs.whop.com/es/whop-finance/cards.md)
>
> Gasta tu saldo al instante y obtén cashback en comerciantes seleccionados
