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

# Explicación de los códigos de rechazo de pagos

> Una referencia de los códigos de rechazo que devuelven los procesadores de pagos en los pagos fallidos, con lo que significa cada código y cómo puede resolverlo el cliente.

Cuando el procesador de pagos rechaza un pago, recibirás uno de estos códigos de rechazo concretos. Consulta qué significa cada código y cómo resolverlo:

| Motivo del rechazo | Explicación |
| - | - |
| `insufficient_funds` | Tu tarjeta no tiene fondos suficientes para completar esta compra. Usa otro método de pago o comprueba que tu cuenta tenga fondos suficientes. |
| `lost_card` | El emisor de la tarjeta rechazó este pago porque el titular notificó la pérdida de la tarjeta. Usa otra tarjeta para completar tu compra. |
| `stolen_card` | El emisor de la tarjeta rechazó este pago porque el titular notificó el robo de la tarjeta. Usa otra tarjeta para completar tu compra. |
| `expired_card` | Tu tarjeta ha caducado. Comprueba la fecha de caducidad e inténtalo de nuevo, o usa otra tarjeta. |
| `suspected_fraud` | Los controles de seguridad impidieron el pago. Contacta con tu banco para obtener más información o prueba con otro método de pago. |
| `invalid_card_number` | El número de la tarjeta es incorrecto. Revisa el número de 16 dígitos de tu tarjeta e inténtalo de nuevo. |
| `invalid_cvc` | El código de verificación de la tarjeta (<abbr title="código de verificación de la tarjeta">CVC</abbr>) es incorrecto. Comprueba el código de tres o cuatro dígitos del reverso de tu tarjeta (o del anverso en Amex) e inténtalo de nuevo. |
| `invalid_cvc_or_expiration` | El código de verificación de la tarjeta (<abbr title="código de verificación de la tarjeta">CVC</abbr>) o la fecha de caducidad son incorrectos. Revisa tanto el código de seguridad de tres o cuatro dígitos como la fecha de caducidad en formato <abbr title="mes/año">MM/YY</abbr>. |
| `incorrect_pin` | El número de identificación personal (<abbr title="número de identificación personal">PIN</abbr>) que has introducido es incorrecto. Inténtalo de nuevo con el número correcto. Este rechazo solo se aplica a los pagos realizados con un lector de tarjetas. |
| `authentication_required` | Este pago necesita una verificación adicional. Es posible que tu banco abra su sitio web o te envíe un mensaje de texto para confirmar esta transacción. Completa la verificación para continuar. |
| `card_not_supported` | Esta tarjeta no admite este tipo de compra. Prueba con otra tarjeta de crédito o débito. |
| `currency_not_supported` | Tu tarjeta no admite pagos en esta moneda. Usa otra tarjeta o consulta a tu banco sobre las transacciones internacionales. |
| `duplicate_transaction` | Se acaba de procesar una transacción con el mismo importe y la misma tarjeta. Busca la confirmación en tu correo electrónico. Si no la has recibido, espera unos minutos antes de volver a intentarlo. |
| `generic_decline` | El emisor de tu tarjeta rechazó el pago. Prueba a: 1) usar otra tarjeta, 2) contactar con tu banco o 3) comprobar que tu información de facturación sea correcta. |
| `invalid_account` | Esta tarjeta o la cuenta asociada no son válidas. Usa otra tarjeta o contacta con tu banco para obtener ayuda. |
| `invalid_amount` | El importe del pago supera el límite de tu tarjeta. Prueba con un importe menor o usa otro método de pago. |
| `processing_error` | Un problema temporal interrumpió el procesamiento del pago. Espera un momento e inténtalo de nuevo, o usa otra tarjeta. |
| `restricted_card` | Tu banco tiene restricciones en esta tarjeta que impiden este pago. Contacta con tu banco para activar las compras internacionales u online, o usa otra tarjeta. |
| `card_velocity_exceeded` | Has superado el límite de transacciones o el saldo disponible de tu tarjeta. Prueba con un importe menor o usa otra tarjeta. |
| `contact_issuer` | Contacta con el emisor de tu tarjeta para obtener más información sobre este rechazo. Llama al número que aparece en el reverso de tu tarjeta. |
| `bank_declined` | Tu banco ha rechazado esta transacción. Prueba con otra tarjeta o contacta con tu banco. |
| `regulatory_blocked` | Las restricciones normativas de tu región impiden esta transacción. Prueba con otro método de pago o contacta con el soporte para conocer alternativas. |
| `transaction_not_permitted` | El emisor de tu tarjeta no permite este tipo de transacción. Usa otra tarjeta o contacta con tu banco para activar este tipo de transacción. |
| `card_type_not_supported` | El procesador de pagos no admite este tipo de tarjeta. Prueba con otra tarjeta. |
| `issuer_not_found` | El emisor de la tarjeta rechazó el pago debido a datos de la tarjeta o de facturación incorrectos. Verifica el número de tu tarjeta, la fecha de caducidad y la dirección de facturación, e inténtalo de nuevo. |
| `closed_account` | La cuenta de la tarjeta ya no está abierta. Usa otra tarjeta para completar tu compra. |
| `issuer_unavailable` | El procesador de pagos no pudo contactar con el emisor de tu tarjeta para autorizar este pago. Normalmente es algo temporal. Inténtalo de nuevo en unos minutos o usa otra tarjeta. |
| `invalid_zip` | El código postal de facturación no coincide con los registros de tu tarjeta. Introduce el código postal asociado a la dirección de facturación de tu tarjeta. |
| `invalid_expiry_month` | El mes de caducidad no es válido. Introduce un mes válido (01-12) e inténtalo de nuevo. |
| `invalid_expiry_year` | El año de caducidad no es válido. Introduce un año válido de 2 o 4 dígitos (p. ej., 25 o 2025) e inténtalo de nuevo. |
| `invalid_expiry` | La fecha de caducidad no es válida. Introduce una fecha válida en formato <abbr title="mes/año">MM/YY</abbr> y comprueba que la tarjeta no haya caducado. |
| `invalid_transaction` | El banco emisor ha rechazado esta transacción. Puede deberse a un número de tarjeta incorrecto, una tarjeta caducada, una tarjeta no válida, una fecha de caducidad errónea, una dirección de facturación o un código postal que no coinciden, o varios intentos de transacción seguidos. Verifica los datos de tu tarjeta e inténtalo de nuevo. |
| `cannot_authorize` | El procesador de pagos no pudo autorizar este pago. Prueba con otra tarjeta o contacta con tu banco para obtener más información. |
| `pin_required` | Esta tarjeta requiere un número de identificación personal (<abbr title="número de identificación personal">PIN</abbr>) para la transacción. Usa un lector de tarjetas compatible o prueba con otra tarjeta. |
| `pin_try_exceeded` | Has introducido un número de identificación personal (<abbr title="número de identificación personal">PIN</abbr>) incorrecto demasiadas veces. La tarjeta se ha bloqueado temporalmente por seguridad. Contacta con tu banco o usa otra tarjeta. |
| `high_risk` | Motivos de seguridad impidieron el pago. Prueba con otra tarjeta o contacta con el soporte para obtener ayuda. |
| `test_mode_decline` | Parece que se trata de un número de tarjeta de prueba. Usa una tarjeta de crédito o débito real para completar tu compra. |
| `merchant_blacklist` | Los controles de seguridad bloquearon este pago. Prueba con otra tarjeta o contacta con el soporte para obtener ayuda. |
| `reenter_transaction` | Tu banco no pudo procesar este pago. Inténtalo de nuevo, usa otra tarjeta o contacta con tu banco para obtener más información. |
| `invalid_pin` | El número de identificación personal (<abbr title="número de identificación personal">PIN</abbr>) que has introducido es incorrecto. Inténtalo de nuevo con el número correcto de esta tarjeta. |
| `pin_required_as` | Esta tarjeta requiere un número de identificación personal (<abbr title="número de identificación personal">PIN</abbr>) para la transacción. Usa un lector de tarjetas compatible o prueba con otra tarjeta. |
| `withdrawal_count_limit_exceeded` | Has superado el límite diario de transacciones o el saldo disponible de tu tarjeta. Inténtalo de nuevo mañana o usa otra tarjeta. |
| `invalid_country` | El país de facturación no coincide con los registros de tu tarjeta. Verifica el país de tu dirección de facturación e inténtalo de nuevo. |
| `issuer_error` | Tu banco detectó un problema, pero no pudo identificarlo. Inténtalo de nuevo en unos minutos o contacta directamente con tu banco para obtener ayuda. |


## Related topics

- [Crear un enlace de pago para aceptar pagos](https://docs.whop.com/es/manage-your-business/payment-processing/create-checkout-link.md)
- [Revisa las reclamaciones de reembolso en el Centro de resolución](https://docs.whop.com/es/payments/resolution-center.md)
- [Rechazos de tarjeta y reglas de riesgo](https://docs.whop.com/es/whop-finance/card-declines-and-risk-rules.md)
