# Códigos de rechazo de Stripe

Aprende sobre los códigos de rechazo de Stripe y cómo resolverlos cuando falla un pago.

Stripe usa sus propios códigos de rechazo que cubren muchas de las mismas posibles razones que los [códigos de rechazo del emisor](https://docs.stripe.com/declines/network-codes.md). Los códigos de rechazo de Stripe amplían los códigos de rechazo del emisor, ya que ofrecen más detalles sobre la razón específica del pago rechazado. 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 la API
> 
> Algunos [errores de la 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 rechazo de tarjeta

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

| Código de rechazo | Descripción | Próximos pasos |
| --- | --- | --- |
| `authentication_required` | La tarjeta se rechazó porque la transacción exige una 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 usan los front-ends de Stripe, en la mayoría de los casos, si un emisor genera un rechazo de pago recuperable, se activa un flujo de autenticación. Esto permite que el cliente vuelva a intentarlo y autentique la tarjeta. En algunos casos, como con 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 lo reintente. Si el emisor de la tarjeta envía este [código de rechazo](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 tendrá que comunicarse con el 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 rechazó el pago nuevamente. | Ejecuta el flujo EMV 3D Secure (3DS) o Autenticación reforzada de clientes (SCA). Para los pagos fuera de la sesión, recopila y prepara la autenticación durante la sesión primero, y luego recurre a 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 rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `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 excedió el límite del saldo, del crédito o del importe de la transacción disponible en su tarjeta. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `currency_not_supported` | La tarjeta no admite la moneda especificada. | El cliente debe ponerse en contacto con el emisor para verificar si la tarjeta se puede utilizar para compras en la moneda especificada. |
| `do_not_honor` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| (Obsoleto)`do_not_try_again` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `duplicate_transaction` | Hace muy poco se realizó otra transacción por el mismo importe con los mismos datos de tarjeta. | Verifica si ya existe un pago reciente. |
| `expired_card` | La tarjeta está vencida. | El cliente debe utilizar otra tarjeta. |
| `fraudulent` | El pago se rechazó porque Stripe sospecha que es fraudulento. | No des más detalles al cliente. Preséntalo como lo harías con un `generic_decline`. |
| `generic_decline` | La tarjeta se rechazó por un motivo desconocido, o Stripe Radar o Adaptive Acceptance [bloqueó el pago](https://docs.stripe.com/declines.md#blocked-payments). | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `incorrect_address` | La dirección que ingresó el cliente es incorrecta. | El cliente debe volver a intentarlo usando la dirección correcta. |
| `incorrect_cvc` | El número de CVC no es correcto. | El cliente debe volver a intentarlo usando el CVC correcto. |
| `incorrect_number` | El número de tarjeta no es correcto. | El cliente debe volver a intentarlo usando el número de tarjeta correcto. |
| `incorrect_pin` | El PIN ingresado no es correcto. Este código de rechazo solo se aplica a pagos efectuados con un lector de tarjetas. | El cliente debe volver a intentarlo usando el PIN correcto. |
| `incorrect_zip` | El código postal no es correcto. | El cliente debe volver a intentarlo usando el código postal de facturación correcto. |
| `insufficient_funds` | No hay fondos suficientes en la tarjeta para hacer 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 está funcionando 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 hacer compras por ese importe. |
| `invalid_cvc` | El número de CVC no es correcto. | El cliente debe volver a intentarlo usando el CVC correcto. |
| `invalid_expiry_month` | El mes de vencimiento no es válido. | El cliente debe volver a intentarlo usando la fecha de vencimiento correcta. |
| `invalid_expiry_year` | El año de vencimiento no es válido. | El cliente debe volver a intentarlo usando la fecha de vencimiento correcta. |
| `invalid_number` | El número de tarjeta no es correcto. | El cliente debe volver a intentarlo usando el número de tarjeta correcto. |
| `invalid_pin` | El PIN ingresado es incorrecto. | El cliente debe volver a intentarlo usando el PIN correcto. |
| `issuer_not_available` | No se pudo establecer contacto con el emisor de la tarjeta, así que no se pudo 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 rechazó porque la tarjeta se denunció como extraviada. | El motivo específico del rechazo no debe comunicarse al cliente. Debe presentarse como un código `generic_decline`. |
| `merchant_blacklist` | El pago se rechazó porque coincide con un valor de la lista de bloqueo del usuario de Stripe. | No des más detalles al cliente. Preséntalo como lo harías con un `generic_decline`. |
| `new_account_information_available` | La tarjeta o la cuenta a la que está conectada la tarjeta no es válida. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `no_action_taken` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `not_permitted` | El pago no está permitido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `offline_pin_required` | La tarjeta se rechazó porque se necesita un PIN. | El cliente debe volver a intentarlo insertando la tarjeta e ingresando un PIN. |
| `online_or_offline_pin_required` | La tarjeta se rechazó porque se necesita un PIN. | Si el lector de tarjetas es compatible con el ingreso del PIN en línea, se le debe solicitar el PIN al cliente sin crear una nueva transacción. Si el lector de tarjetas no admite el ingreso del PIN en línea, el cliente deberá intentarlo de nuevo insertando su tarjeta e ingresando el PIN. |
| `pickup_card` | El cliente no puede usar esta tarjeta para efectuar este pago (es posible que haya sido denunciada por extravío o robo). | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `pin_try_exceeded` | Se superó el número permitido de intentos de ingreso del PIN. | El cliente debe utilizar otra tarjeta u otro método de pago. |
| `processing_error` | Se produjo un error al procesar la tarjeta. | Pídele al cliente que vuelva a intentar el pago. Si aún no se puede procesar, el cliente debe comunicarse con el emisor de su tarjeta. |
| `reenter_transaction` | El emisor no pudo 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 haya sido denunciada por extravío o robo). | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `revocation_of_all_authorizations` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `revocation_of_authorization` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `security_violation` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `service_not_allowed` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `stolen_card` | El pago se rechazó porque la tarjeta se denunció como robada. | No des más detalles al cliente. Preséntalo como lo harías con un `generic_decline`. |
| `stop_payment_order` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| `testmode_decline` | Se utilizó el número de una tarjeta de prueba de Stripe. | Debe utilizarse una tarjeta real para efectuar pagos. |
| `transaction_not_allowed` | La tarjeta se rechazó por un motivo desconocido. | Para obtener más información, el cliente debe ponerse en contacto con el emisor de la tarjeta. |
| (Obsoleto)`try_again_later` | La tarjeta se rechazó por un motivo desconocido. | Pide al cliente que vuelva a intentar el pago. Si se rechazan los pagos sucesivos, el cliente deberá ponerse en contacto con el emisor de la tarjeta para obtener más información. |
| `withdrawal_count_limit_exceeded` | El cliente superó 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 se rechazó porque la transacción requiere autenticación. | Pídele al cliente que vuelva a intentar el pago acercando su dispositivo móvil nuevamente. |

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

Los siguientes códigos de pago rechazado de Stripe pueden utilizarse para pagos con Métodos de Pago Locales (LPM):

| Código de rechazo | 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 rechazó el pago. | El proveedor de servicios de pago rechazó el pago. |
| `customer_declined` | `generic_decline` | El cliente rechazó el pago. | El cliente rechazó este pago. |
| `code_invalid` | `generic_decline` | El código BLIK no es válido o tiene un formato incorrecto. | El código especificado no era un código BLIK válido. |
| `code_expired` | `generic_decline` | El código BLIK caducó, ya se usó o excedió su período de validez. | El código especificado ha vencido. Los códigos BLIK vencen después de 2 minutos, así que debes solicitar otro código al cliente. |
| `invalid_customer_account` | `invalid_customer_account` | No podemos hacer un cargo en la cuenta del cliente. | No podemos cobrarle al cliente en su cuenta. Los intentos de reintento podrían funcionar después de que el cliente tome alguna acción 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 efectúen correctamente una vez que el cliente tome medidas para resolver el problema de 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 porque el acuerdo de facturación no es válido. Los reintentos no se efectuarán correctamente. |
| `expired_card` | `partner_expired_card` | La tarjeta registrada con el proveedor de servicios de pago ha caducado. | La tarjeta registrada en el proveedor de servicios de pago está vencida. Es posible que los reintentos se efectúen correctamente una vez que el cliente tome medidas para resolver el problema de su cuenta. |
| `processing_error` | `partner_processing_error` | El proveedor de servicios de pago tuvo un error de procesamiento. | El proveedor de servicios de pago tuvo un error de procesamiento. |
| `insufficient_funds` | `partner_insufficient_funds` | El cliente no tiene fondos suficientes con el proveedor de servicios de pago. | El cliente tiene fondos insuficientes en el proveedor de servicios de pago. Es posible que los reintentos se efectúen correctamente una vez que el cliente tome medidas para resolver el problema de su cuenta. |
| `currency_not_supported` | `partner_invalid_currency` | El proveedor de servicios de pago no admite esta moneda. | El proveedor de servicios de pago no admite esta moneda. Los reintentos no se efectuarán correctamente. |
| `invalid_amount` | `partner_invalid_amount` | El proveedor de servicios de pago no permite el importe. | El proveedor de servicios de pago no permite el importe. Los reintentos no se efectuarán correctamente. |
| `invalid_business_account` | `invalid_business_account` | La cuenta de empresa está desactivada. | La cuenta de empresa que estás intentando usar 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 se efectúen correctamente. |
| `partner_high_risk_customer` | `partner_high_risk_customer` | El proveedor de servicios de pago etiquetó a este cliente como de alto riesgo. | El proveedor de servicios de pago etiquetó a este cliente como de alto riesgo. |
| `compliance_violation` | `compliance_violation` | El pago infringe las condiciones de uso, las reglas del programa o las leyes vigentes. | El pago no cumple las Condiciones de uso, las normas del programa o la legislación aplicable. Los reintentos no se efectuarán correctamente. |
| `payment_disputed` | `payment_disputed` | Hay una disputa por el pago. | Hay una disputa relativa al pago. Si la disputa se resuelve a favor de la empresa, es posible que los reintentos se efectúen correctamente. |
| `invalid_authorization` | `invalid_authorization` | La autorización no es válida o ha sido revocada. | El pago no recibió autorización o esta se revocó. Los reintentos no se efectuará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 se efectuarán correctamente. |
| `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 venció. Es posible que los nuevos intentos se completen correctamente después de que el cliente actualice su información de pago. |
| `duplicate_transaction` | `partner_duplicate_transaction` | Hace poco se envió una transacción con detalles idénticos. | Hace poco se envió al socio una transacción con detalles 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 admite esta acción. | El proveedor de servicios de pago no admite esta acción. Los reintentos no se realizarán correctamente. |
| `lost_or_stolen_card` | `lost_or_stolen_card` | Se rechazó el pago porque la tarjeta se reportó como perdida o robada. | El motivo específico del pago rechazado no se le debe informar al cliente. En su lugar, preséntalo como un `partner_generic_decline`. |
| `card_already_activated` | `card_already_activated` | La tarjeta ya se activó. | La tarjeta ya se activó. Los reintentos no se realizarán correctamente. |
| `invalid_track_data` | `invalid_track_data` | Los datos de la tarjeta son incorrectos. | Los datos de la tarjeta son incorrectos. El cliente debe comunicarse con el emisor de su tarjeta para comprobar que la tarjeta funcione correctamente. |