# Códigos de pagos rechazados de Stripe

Más información sobre los códigos de pagos rechazados de Stripe y cómo resolverlos cuando un pago falla.

Stripe utiliza sus propios códigos de pago rechazado, que cubren muchas de las mismas razones potenciales que los [códigos de rechazo del emisor](https://docs.stripe.com/declines/network-codes.md). Los códigos de pago rechazado de Stripe amplían los códigos de rechazo del emisor al proporcionar más detalles sobre la razón específica del rechazo. Además de un código de rechazo, un error puede contener un [advice_code](https://docs.stripe.com/declines/card.md#retrying-issuer-declines) con los siguientes pasos sugeridos.

> #### Otros errores de API
> 
> Algunos [errores de API](https://docs.stripe.com/api/errors.md) incluyen un atributo de [código](https://docs.stripe.com/api/errors.md#errors-code) para ayudarte a [resolverlos](https://docs.stripe.com/error-handling.md).

## Códigos de pagos rechazados con tarjeta

Estos son los códigos de rechazo de Stripe que se utilizan para los pagos con tarjeta:

| Código de pago rechazado | Descripción | Próximos pasos |
| --- | --- | --- |
| `authentication_required` | La tarjeta se ha rechazado porque la transacción requiere autenticación, como *3D Secure* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments). | Cuando se utilizan los front-ends de Stripe, en la mayoría de los casos, el pago rechazado temporal por parte de un emisor activa un flujo de autenticación, lo que permite al cliente volver a intentarlo y autenticar su tarjeta. En algunos casos, como en los *pagos fuera de la sesión* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information), es posible que tengas que pedirle al cliente que vuelva a intentarlo. Si el emisor de la tarjeta envía este [código de pago rechazado](https://support.stripe.com/questions/authenticated-payment-declined-with-an-authentication-required-decline-code) a pesar de que la transacción se haya autenticado correctamente, el cliente deberá contactar al emisor de la tarjeta para obtener más información. |
| `authentication_not_handled` | Relacionado con `authentication_required`. El cliente intentó continuar sin realizar la autenticación requerida, por lo que el emisor volvió a rechazar el pago. | Ejecuta EMV 3D Secure (3DS) o la autenticación reforzada de clientes (SCA). Para los pagos fuera de la sesión, cobra y prepara la autenticación durante la sesión primero y, a continuación, vuelve a la autenticación durante la sesión si es necesario. |
| `approve_with_id` | No se puede autorizar el pago. | Reintenta el pago. Si aun así no se puede procesar, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `call_issuer` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `card_not_supported` | La tarjeta no admite este tipo de compras. | El cliente debe ponerse en contacto con el emisor para corroborar si su tarjeta se puede utilizar para hacer este tipo de compras. |
| `card_velocity_exceeded` | El cliente ha excedido el límite del saldo, del crédito o del importe de la transacción disponible en su tarjeta. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `currency_not_supported` | La tarjeta no admite las divisas especificadas. | El cliente debe ponerse en contacto con el emisor para verificar si la tarjeta se puede utilizar para compras en la divisa especificada. |
| `do_not_honor` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| (Obsoleto)`do_not_try_again` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `duplicate_transaction` | Hace muy poco se realizó otra transacción por el mismo importe con una tarjeta con los mismos datos. | Verifica si ya existe un pago reciente. |
| `expired_card` | La tarjeta ha caducado. | El cliente debe utilizar otra tarjeta. |
| `fraudulent` | El pago se ha rechazado porque Stripe sospecha que es fraudulento. | No proporciones información más detallada a tu cliente. En su lugar, muéstralo de la misma forma que `generic_decline`. |
| `generic_decline` | La tarjeta ha sido rechazada por un motivo desconocido o Stripe Radar o Adaptive Acceptance [han bloqueado el pago](https://docs.stripe.com/declines.md#blocked-payments). | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `incorrect_address` | La dirección introducida por el cliente es incorrecta. | El cliente debe volver a intentarlo introduciendo la dirección correcta. |
| `incorrect_cvc` | El número de CVC no es correcto. | El cliente debe volver a intentarlo con el CVC correcto. |
| `incorrect_number` | El número de tarjeta no es correcto. | El cliente debe volver a intentarlo introduciendo el número correcto de la tarjeta. |
| `incorrect_pin` | El PIN introducido es incorrecto. Este código de pago rechazado solo se aplica a los pagos efectuados con un lector de tarjetas. | El cliente debe volver a intentarlo con el PIN correcto. |
| `incorrect_zip` | El código postal es incorrecto. | El cliente debe volver a intentarlo con el código postal de facturación correcto. |
| `insufficient_funds` | No hay fondos suficientes en la tarjeta para efectuar la compra. | El cliente debe utilizar otro método de pago. |
| `invalid_account` | La tarjeta o la cuenta a la que está conectada la tarjeta no es válida. | El cliente debe ponerse en contacto con el emisor para verificar si la tarjeta funciona correctamente. |
| `invalid_amount` | El importe del pago no es válido o excede el importe permitido. | Si el importe parece correcto, el cliente debe ponerse en contacto con el emisor de la tarjeta para averiguar si puede efectuar compras por ese importe. |
| `invalid_cvc` | El número de CVC no es correcto. | El cliente debe volver a intentarlo con el CVC correcto. |
| `invalid_expiry_month` | El mes de caducidad no es válido. | El cliente debe volver a intentarlo usando la fecha de caducidad correcta. |
| `invalid_expiry_year` | El año de caducidad no es válido. | El cliente debe volver a intentarlo usando la fecha de caducidad correcta. |
| `invalid_number` | El número de tarjeta no es correcto. | El cliente debe volver a intentarlo introduciendo el número correcto de la tarjeta. |
| `invalid_pin` | El PIN ingresado es incorrecto. | El cliente debe volver a intentarlo con el PIN correcto. |
| `issuer_not_available` | No es posible contactar con el emisor de la tarjeta, así que no se puede autorizar el pago. | Reintenta el pago. Si aun así no se puede procesar, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `lost_card` | El pago se ha rechazado porque la tarjeta figura como tarjeta perdida. | El motivo específico del rechazo del pago no debe comunicarse al cliente. En su lugar, preséntalo como un `generic_decline`. |
| `merchant_blacklist` | El pago se ha rechazado porque coincide con un valor de la lista de bloqueo del usuario de Stripe. | No proporciones información más detallada a tu cliente. En su lugar, muéstralo de la misma forma que `generic_decline`. |
| `new_account_information_available` | La tarjeta o la cuenta a la que está conectada la tarjeta no es válida. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `no_action_taken` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `not_permitted` | El pago no está permitido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `offline_pin_required` | La tarjeta se ha rechazado porque hace falta un PIN. | El cliente debe volver a intentarlo insertando la tarjeta e introduciendo el PIN. |
| `online_or_offline_pin_required` | La tarjeta se ha rechazado porque hace falta un PIN. | Si el lector de la tarjeta es compatible con la introducción del PIN en línea, se le debe solicitar el PIN al cliente sin crear una nueva transacción. Si el lector de la tarjeta no es compatible con la introducción del PIN en línea, el cliente deberá intentarlo de nuevo insertando su tarjeta e introduciendo el PIN. |
| `pickup_card` | El cliente no puede usar esta tarjeta para efectuar este pago (es posible que se haya comunicado su pérdida o robo). | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `pin_try_exceeded` | Se ha superado el número permitido de intentos de introducción del PIN. | El cliente debe utilizar otra tarjeta u otro método de pago. |
| `processing_error` | Ha ocurrido un error mientras se procesaba la tarjeta. | Pídele al cliente que vuelva a intentar el pago. Si sigue sin poder procesarse, el cliente debe ponerse en contacto con el emisor de su tarjeta. |
| `reenter_transaction` | El emisor no ha podido procesar el pago por un motivo desconocido. | El pago debe reintentarse. Si aun así no se puede procesar, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `restricted_card` | El cliente no puede usar esta tarjeta para efectuar este pago (es posible que se haya comunicado su pérdida o robo). | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `revocation_of_all_authorizations` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `revocation_of_authorization` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `security_violation` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `service_not_allowed` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `stolen_card` | El pago se ha rechazado porque la tarjeta figura como robada. | No proporciones información más detallada a tu cliente. En su lugar, muéstralo de la misma forma que `generic_decline`. |
| `stop_payment_order` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `testmode_decline` | Se ha utilizado el número de una tarjeta de prueba de Stripe. | Debe utilizarse una tarjeta real para efectuar pagos. |
| `transaction_not_allowed` | La tarjeta se ha rechazado por un motivo desconocido. | El cliente debe ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| (Obsoleto)`try_again_later` | La tarjeta se ha rechazado por un motivo desconocido. | Pide al cliente que vuelva a intentarlo. Si se rechazan los siguientes pagos, el cliente deberá ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `withdrawal_count_limit_exceeded` | El cliente ha excedido el límite del saldo o del crédito disponible en su tarjeta. | El cliente debe utilizar otro método de pago. |
| `mobile_device_authentication_required` | La tarjeta ha sido rechazada porque la transacción requiere autenticación. | Pídele al cliente que vuelva a intentar el pago acercando de nuevo su dispositivo móvil. |

## Códigos de pago rechazados de métodos de pago locales

Los siguientes códigos de pago rechazado de Stripe se pueden utilizar para pagos con métodos de pago locales (LPM):

A partir de la versión de la API `2026-09-30.endive`, los pagos con BLIK pueden devolver `code_invalid`, `code_expired`, `insufficient_funds`, `customer_declined`, `payment_limit_exceeded` y `partner_generic_decline`. Las versiones anteriores de la API devuelven `generic_decline` para esos fallos de BLIK.

| Código de pago rechazado | Motivo del resultado del cargo | Mensaje del vendedor | Mensaje de error de la API |
| --- | --- | --- | --- |
| `partner_generic_decline` | `partner_generic_decline` | El proveedor de servicios de pago ha rechazado el pago. | El proveedor de servicios de pago ha rechazado el pago. |
| `customer_declined` | `generic_decline` | El cliente rechazó el pago. | El cliente ha rechazó este pago. |
| `code_invalid` | `generic_decline` | El código BLIK no es válido o tiene un formato incorrecto. | El código que se ha transmitido no era un código de BLIK válido. |
| `code_expired` | `generic_decline` | El código BLIK ha caducado, ya se ha usado o ha superado su período de validez. | El código que se ha transmitido ha caducado. Los códigos de BLIK caducan cuando transcurren 2 minutos, debes solicitar otro código al cliente. |
| `invalid_customer_account` | `invalid_customer_account` | No podemos hacer cargos en la cuenta del cliente. | No podemos realizar el cargo en la cuenta del cliente. Es posible que los intentos posteriores sean exitosos una vez que el cliente haya tomado medidas para resolver el problema con su cuenta. |
| `payment_limit_exceeded` | `payment_limit_exceeded` | El pedido supera un límite en la cuenta del cliente. | El pedido supera un límite en la cuenta del cliente. Es posible que los reintentos se ejecuten correctamente si el cliente toma medidas para resolver el problema en su cuenta. |
| `invalid_billing_agreement` | `invalid_billing_agreement` | El acuerdo de facturación del cliente no es válido. | El método de pago del cliente no es válido debido a un acuerdo de facturación no válido. Los reintentos no serán exitosos. |
| `expired_card` | `partner_expired_card` | La tarjeta registrada en el proveedor de servicios de pago ha caducado. | La tarjeta registrada con el proveedor de servicios de pago ha caducado. Es posible que los reintentos sean exitosos si el cliente toma medidas para resolver el problema en su cuenta. |
| `processing_error` | `partner_processing_error` | El proveedor de servicios de pago ha detectado un error de procesamiento. | El proveedor de servicios de pago ha detectado un error de procesamiento. |
| `insufficient_funds` | `partner_insufficient_funds` | El cliente no tiene fondos suficientes con el proveedor de servicios de pago. | El cliente no tiene fondos suficientes en el proveedor de servicios de pago. Es posible que los reintentos sean exitosos si el cliente toma medidas para resolver el problema en su cuenta. |
| `currency_not_supported` | `partner_invalid_currency` | El proveedor de servicios de pago no soporta esta divisas. | El proveedor de servicios de pago no acepta esta divisa. Los reintentos no se ejecutarán correctamente. |
| `invalid_amount` | `partner_invalid_amount` | El proveedor de servicios de pago no acepta el importe. | El proveedor de servicios de pago no acepta el importe. Los reintentos no se ejecutarán correctamente. |
| `invalid_business_account` | `invalid_business_account` | La cuenta de empresa está desactivada. | La cuenta de empresa que intentas utilizar para procesar un pago o emitir un reembolso está desactivada y no puede enviar ni recibir fondos. Si la cuenta se reactiva, es posible que los reintentos sean exitosos. |
| `partner_high_risk_customer` | `partner_high_risk_customer` | El proveedor de pagos ha etiquetado a este cliente como de alto riesgo. | El proveedor de pagos ha etiquetado a este cliente como de alto riesgo. |
| `compliance_violation` | `compliance_violation` | El pago infringe las condiciones de servicio, las reglas del programa o la legislación aplicable. | El pago incumple las Condiciones de servicio, las reglas del programa o la legislación aplicable. Los reintentos no serán exitosos. |
| `payment_disputed` | `payment_disputed` | Hay una disputa sobre el pago. | Hay una disputa por el pago. Si la disputa se resuelve a favor de la empresa, es posible que los reintentos se ejecuten correctamente. |
| `invalid_authorization` | `invalid_authorization` | La autorización no es válida o ha sido revocada. | Este pago no ha recibido autorización, o su autorización se ha revocado. Los reintentos no se ejecutarán correctamente. |
| `invalid_payment_information` | `invalid_payment_information` | El pago tiene información no válida. | El pago tiene información no válida. Los reintentos no serán exitosos. |
| `partner_payment_not_found` | `partner_payment_not_found` | El proveedor de servicios de pago no puede encontrar este pago. | El proveedor de servicios de pago no puede encontrar este pago. |
| `expired_payment_information` | `expired_payment_information` | El instrumento de pago subyacente ha caducado. | La información de pago ha caducado. Los nuevos intentos podrían completarse con éxito después de que el cliente actualice su información de pago. |
| `duplicate_transaction` | `partner_duplicate_transaction` | Se ha enviado una transacción reciente con datos idénticos. | Se ha enviado al socio una transacción reciente con datos idénticos. |
| `recurring_not_supported_by_bank` | `recurring_not_supported_by_bank` | El banco del cliente no admite pagos recurrentes para este método de pago. | El banco del cliente no admite pagos recurrentes para este método de pago. Solicita al cliente que seleccione un banco que admita pagos recurrentes. |
| `partner_action_not_supported` | `partner_action_not_supported` | El proveedor de servicios de pago no acepta esta acción. | El proveedor de servicios de pago no acepta esta acción. Los reintentos no se ejecutarán. |
| `lost_or_stolen_card` | `lost_or_stolen_card` | El pago ha sido rechazado porque la tarjeta figura como perdida o robada. | El motivo específico del rechazo del pago no debe comunicarse al cliente. En su lugar, preséntalo como un `partner_generic_decline`. |
| `card_already_activated` | `card_already_activated` | La tarjeta ya se ha activado. | La tarjeta ya se ha activado. Los reintentos no se ejecutarán. |
| `invalid_track_data` | `invalid_track_data` | Los datos de la tarjeta son incorrectos. | Los datos de la tarjeta no son correctos. El cliente debe contactar con el emisor para verificar si la tarjeta funciona correctamente. |