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.

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_levelytransaction_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:
- Algunos motivos no se deben mostrar al cliente. Para
lost_card,stolen_cardyfraudulent, 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”. - “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_requiredenvía un enlace de confirmación. -
lost_cardystolen_cardproducen 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_fundsaexpired_carda 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.