PAGOS FALLIDOSSTRIPE

Los códigos de rechazo de Stripe explicados: qué hacer con cada uno

Los códigos de rechazo de Stripe en las renovaciones: rechazos blandos y duros, advice codes, límites de reintentos y qué decirle al cliente en cada caso.

Publicado el 9 min de lectura

Los códigos de rechazo de Stripe explicados: qué hacer con cada uno

Cuando falla una renovación en Stripe, el cargo vuelve con una cadena corta como insufficient_funds o do_not_honor. Esa cadena es la información más útil que recibes sobre el fallo. Te dice si reintentar puede funcionar, si el cliente tiene que hacer algo y qué puedes decirle.

Esta guía recorre los códigos de rechazo que más importan para las suscripciones, agrupados según lo que debes hacer con ellos. Se basa en lo que Stripe documenta en su referencia de códigos de rechazo y en su guía de rechazos de tarjeta (consultadas en noviembre de 2026), y lo indica cuando las propias páginas de Stripe dejan margen de interpretación.

Dónde están los códigos

Un pago con tarjeta fallido en Stripe puede llevar varios campos. Responden a preguntas distintas:

Campo Qué te dice Dónde encontrarlo
decline_code El motivo normalizado de Stripe para el rechazo del emisor, si el emisor dio uno En el error, y en last_payment_error del PaymentIntent
advice_code Qué hacer a continuación: reintentar, no reintentar o revisar los datos de la tarjeta En el error, junto al código de rechazo
network_decline_code El código en bruto de la red de tarjetas En el resultado del cargo
network_advice_code El consejo propio de la red (en Mastercard, sus Merchant Advice Codes) En el resultado del cargo

Stripe añadió los campos de advice y decline code de la red a la API en diciembre de 2024. La documentación de Stripe advierte de que el significado de un network_decline_code difiere entre redes de tarjetas, así que léelo siempre junto con la marca de la tarjeta.

Para las suscripciones, normalmente los leerás desde el webhook invoice.payment_failed: recupera el PaymentIntent de la factura y mira last_payment_error.

Los advice codes van primero

El advice_code es la señal más sencilla, y la guía de rechazos de tarjeta de Stripe documenta tres valores:

  • try_again_later: el emisor rechazó, pero puedes reintentar. Si los reintentos repetidos fallan, el cliente tiene que contactar con su emisor.
  • do_not_try_again: no vuelvas a usar esta tarjeta para esta transacción. Mira el código de rechazo para saber el motivo.
  • confirm_card_data: el emisor rechazó porque algún dato de la tarjeta era incorrecto. El cliente tiene que revisar sus datos.

Si hay un advice code, deja que prevalezca sobre cualquier regla general. Un do_not_try_again en lo que parece un rechazo blando significa parar.

Rechazos blandos y duros

Stripe no etiqueta cada código como blando o duro, pero la distinción es útil y Stripe la usa en su documentación de reintentos:

  • Los rechazos blandos son temporales. La tarjeta es válida; el emisor dijo que no esta vez. Reintentar más tarde puede funcionar.
  • Los rechazos duros significan que la tarjeta no se puede cobrar tal cual. La página de Smart Retries de Stripe enumera los códigos que no reintentará sin un nuevo método de pago: incorrect_number, lost_card, pickup_card, stolen_card, revocation_of_authorization, revocation_of_all_authorizations, authentication_required, highest_risk_level y transaction_not_allowed.

Para esos códigos de rechazo duro, Stripe sigue programando reintentos en la factura, pero un cargo solo se ejecuta cuando se asocia un nuevo método de pago. Si nadie se lo pide al cliente, no pasará nada. Explicamos los reintentos en detalle en cómo funcionan los Smart Retries de Stripe.

Los códigos habituales, y qué hacer

La tabla de abajo cubre los códigos que más verás en las renovaciones de suscripción. “Siguiente paso según Stripe” parafrasea la referencia de códigos de rechazo; “En una suscripción” es nuestra lectura práctica.

Código Descripción y siguiente paso según Stripe ¿Reintentar? En una suscripción
insufficient_funds Fondos insuficientes; el cliente debería usar otro método de pago Sí, más tarde Reintentar en un mejor momento (tras un probable día de cobro); escribir al cliente con un enlace de actualización
generic_decline Rechazado por un motivo desconocido, o bloqueado por Radar; el cliente contacta con el emisor Unas cuantas veces Reintentar; escribir; sugerir al cliente que llame a su banco o pruebe otra tarjeta
do_not_honor Rechazo genérico del emisor sin motivo concreto Unas cuantas veces Igual que generic_decline
processing_error Error al procesar la tarjeta; volver a intentarlo, luego contactar con el emisor Sí Reintentar pronto; escribir solo si sigue fallando
card_velocity_exceeded El cliente superó el saldo, el límite de crédito o el límite de transacciones; contactar con el emisor Sí, más tarde Reintentar más tarde; mencionar un límite de gasto en el correo
expired_card La tarjeta ha caducado; usar otra tarjeta No Comprobar primero si hubo una actualización automática de la tarjeta; si no, pedir una nueva tarjeta
incorrect_cvc El CVC es incorrecto; volver a intentarlo con el CVC correcto No Pedir al cliente que vuelva a introducir su tarjeta en la página de actualización
incorrect_number El número de tarjeta es incorrecto No Pedir una nueva tarjeta
lost_card, stolen_card Denunciada como perdida o robada; presentarlo como un rechazo genérico No Pedir una nueva tarjeta, sin mencionar el motivo
pickup_card La tarjeta no se puede usar para este pago (posiblemente denunciada como perdida o robada); contactar con el emisor No Pedir una nueva tarjeta
fraudulent Stripe sospecha fraude; mostrar el mismo mensaje que un rechazo genérico No Tratarlo con cuidado; no revelar el motivo
authentication_required El banco exige que el cliente se autentique No sin el cliente Enviar un enlace para confirmar el pago; consulta la SCA en las renovaciones
revocation_of_authorization, stop_payment_order Stripe los enumera con un motivo desconocido; el cliente contacta con el emisor No Pedir un nuevo método de pago; comprobar si el cliente quería dejar de pagar
transaction_not_allowed No permitido con esta tarjeta No Pedir otra tarjeta u otro método de pago

Dos puntos son fáciles de pasar por alto:

  1. Algunos motivos no se deben mostrar al cliente. Para lost_card, stolen_card y fraudulent, la referencia de Stripe dice que se presente el rechazo como un rechazo genérico. Tu correo de recuperación debe decir “tu pago ha sido rechazado”, nunca “tu tarjeta ha sido denunciada como robada”.
  2. “Contacta con tu emisor” es una instrucción real. En los rechazos genéricos, una llamada al banco a menudo resuelve el bloqueo. Está bien decirlo en el correo, en pocas palabras.

Los límites de reintentos son reales

Reintentar no es gratis, ni siquiera en los rechazos blandos. Las redes de tarjetas limitan la frecuencia con la que un comerciante puede reintentar una tarjeta rechazada, y los emisores pueden tratar los reintentos excesivos como una señal de fraude.

Según el artículo de soporte de Stripe sobre los pagos bloqueados por reintentos excesivos (consultado en noviembre de 2026), las reglas de Visa prohíben en general más de 15 reintentos de un mismo pago en 30 días. Para las transacciones de Visa con precios integrados, Stripe bloquea los reintentos después del 15.º intento cuando considera que la probabilidad de éxito es baja. Los valores por defecto de Stripe (8 intentos con Smart Retries) quedan muy por debajo, pero una lógica de reintentos propia fuera de Stripe puede superarlo si no tienes cuidado.

La señal equivalente de Mastercard es el Merchant Advice Code, que Stripe expone como network_advice_code. La documentación de los procesadores, como la referencia de merchant advice codes de Braintree, describe códigos que significan “no volver a intentarlo” y uno que significa que el titular canceló el pago recurrente. Cuando los veas, deja de reintentar esa tarjeta.

Reglas prácticas:

  • Cuenta cada intento por factura, incluidos los que dispara tu propio código.
  • Para de inmediato ante un rechazo duro o un advice do_not_try_again.
  • No reintentes la misma tarjeta varias veces en un día “por si acaso”.
  • Espacia los reintentos de los rechazos blandos, y alinéalos con el momento en que probablemente haya dinero disponible.

Qué decirle al cliente, por grupo

La mayoría de los equipos envían el mismo correo para cada fallo. Unas pocas variaciones por grupo de rechazo funcionan mejor y no suponen mucho trabajo extra.

Grupo Códigos Mensaje del correo
Fondos o límites insufficient_funds, card_velocity_exceeded “Lo volveremos a intentar el [fecha]. Si prefieres usar otra tarjeta, actualízala aquí.”
Poco claro generic_decline, do_not_honor, processing_error “Tu banco ha rechazado el pago. Suele ser un bloqueo temporal; una llamada rápida a tu banco, u otra tarjeta, normalmente lo soluciona.”
Tarjeta inutilizable expired_card, lost_card, stolen_card, pickup_card, incorrect_number “Necesitamos una nueva tarjeta para mantener activa tu suscripción.” Sin dar el motivo.
Autenticación authentication_required “Tu banco te pide que confirmes este pago. Solo lleva un minuto.”
Datos de la tarjeta incorrect_cvc, advice confirm_card_data “Algunos datos de la tarjeta no coinciden. Vuelve a introducir tu tarjeta.”

Hay correos listos para usar para cada paso en nuestras plantillas de correos de recuperación.

Registrar bien los códigos de rechazo

No puedes mejorar lo que no mides. Para cada renovación fallida, guarda:

  • ID de la factura, ID del cliente, importe y moneda.
  • Número de intento y fecha.
  • decline_code, advice_code, network_decline_code, network_advice_code.
  • Marca de la tarjeta, tipo de financiación (crédito, débito, prepago) y país.
  • Resultado: recuperado (y cómo: reintento, nueva tarjeta, autenticación) o perdido.

Con unos meses de datos, puedes responder a las preguntas que importan: qué códigos se recuperan con un reintento y cuáles solo cuando el cliente actúa, si las tarjetas prepago fallan más a menudo (consulta tarjetas prepago y virtuales) y si son tus correos o tus reintentos los que hacen la mayor parte del trabajo.

Agrupar para los informes

Los códigos en bruto son demasiado detallados para un informe mensual. Agrúpalos:

Grupo del informe Códigos
Blando: fondos insufficient_funds, card_velocity_exceeded
Blando: poco claro generic_decline, do_not_honor, processing_error, try_again_later
Duro: tarjeta expired_card, lost_card, stolen_card, pickup_card, incorrect_number, incorrect_cvc
Duro: autorización revocation_of_authorization, revocation_of_all_authorizations, stop_payment_order, transaction_not_allowed
Autenticación authentication_required
Riesgo fraudulent, highest_risk_level

Conserva el código en bruto en tus datos para poder reagrupar después. Stripe añade y retira códigos con el tiempo; la referencia de Stripe ya marca algunos códigos antiguos como obsoletos en favor de los advice codes.

Probar la gestión de los rechazos

Stripe ofrece números de tarjeta de prueba que disparan códigos de rechazo concretos. Antes de poner en marcha cualquier lógica de recuperación, pasa cada grupo por el modo test:

  • Un rechazo blando programa un reintento y envía el primer correo.
  • Un rechazo duro envía un correo de “se necesita una nueva tarjeta” y no reintenta la misma tarjeta.
  • authentication_required envía un enlace de confirmación.
  • lost_card y stolen_card producen un mensaje genérico.
  • Un pago correcto (invoice.paid) detiene todos los correos y reintentos.
  • Cada intento se registra con sus códigos.

Errores comunes

  • Tratar todos los rechazos igual. Reintentar ocho veces una tarjeta robada no recupera nada y puede contar en tu contra ante la red.
  • Decirle al cliente el motivo en bruto. “Do not honor” no significa nada para los clientes, y algunos motivos no se deben revelar en absoluto.
  • Ignorar los advice codes. Existen precisamente para decirte si reintentar.
  • Leer solo el primer fallo. El código puede cambiar entre intentos; una tarjeta puede pasar de insufficient_funds a expired_card a lo largo de una ventana de reintentos larga.
  • Ninguna salida para los rechazos duros. Si el único camino de recuperación es un reintento, los rechazos duros se pierden por diseño.

Para la visión completa de la recuperación de pagos fallidos, de los reintentos a los correos y la medición, consulta cómo recuperar pagos fallidos en Stripe.

Cómo ayuda NoChurn

NoChurn lee el código de rechazo de cada renovación fallida y trata cada grupo de forma distinta. Los rechazos blandos se reintentan en momentos basados en los días de cobro probables y la hora local del cliente (o mantienes los Smart Retries de Stripe). Los rechazos duros y las solicitudes de autenticación se saltan los reintentos inútiles y pasan directamente a un correo de recuperación escrito por IA, revisado antes de enviarse, con un enlace a una página alojada de actualización de la tarjeta. Los motivos sensibles nunca se muestran al cliente, y cada decisión se registra con su código.

Se conecta a Stripe en un clic, y el precio depende solo del MRR, sin ninguna parte de los ingresos recuperados. Consulta pagos fallidos y los precios.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión