RECUPERACIÓN DE PAGOSRECURLY

Cómo configurar la recuperación de pagos (dunning) en Recurly

Cómo gestiona Recurly los pagos fallidos: campañas y ciclos de dunning, Intelligent Retries, correos, facturas vencidas y fallidas, datos de pago y webhooks.

Publicado el 8 min de lectura

Cómo configurar la recuperación de pagos (dunning) en Recurly

Recurly tiene una de las configuraciones de dunning nativas más completas entre las plataformas de facturación de suscripciones. Los reintentos, los correos, las acciones de fin de ciclo y las páginas de facturación para los clientes vienen integrados, y la mayor parte del trabajo consiste en elegir ajustes sensatos y conectar los webhooks adecuados a tu app. Esta guía recorre cada pieza y te da una lista de configuración que puedes aplicar hoy.

Todo lo específico de Recurly viene de su propia documentación: Dunning campaigns, Intelligent retries, Static retries, Dunning 101: Understanding dunning windows, Hosted account management y la referencia de webhooks (todo consultado en noviembre de 2026). Recurly también vende un producto aparte, Recurly Commerce, con sus propios ajustes de dunning; esta guía cubre Recurly Subscriptions.

Cómo reparte Recurly el trabajo: reintentos y dunning

Recurly trata dos cosas por separado:

  • Los reintentos deciden cuándo se vuelve a intentar un cargo rechazado.
  • El dunning decide qué oye el cliente, durante cuánto tiempo y qué pasa con la factura y la suscripción al final.

Los dos se ejecutan sobre la misma factura a la vez, pero se configuran en lugares distintos. Tener en cuenta esa separación hace que el resto de los ajustes sea más fácil de entender.

Reintentos: Intelligent Retries y reintentos estáticos

Intelligent Retries

Según la documentación de Intelligent retries, Recurly usa un modelo de machine learning para elegir cuándo reintentar los pagos recurrentes con tarjeta rechazados. Se centra en los rechazos blandos (como los fondos insuficientes). Los límites documentados:

  • Los reintentos se detienen a los 20 intentos de transacción en total o a los 60 días desde la creación de la factura, lo que llegue antes.
  • Intelligent Retries no se aplica a los métodos de débito directo como ACH y SEPA. Recurly los documenta aparte en direct debit retries.
  • Los rechazos duros se tratan en general como definitivos y no se reintentan automáticamente, con algunas excepciones documentadas, por ejemplo cuando el cliente o el Account Updater cambian los datos de facturación.

Algo que comprobar en tu propia cuenta: una entrada del changelog de Recurly de agosto de 2026 describe que los rechazos blandos se reintentan hasta 20 veces por periodo de 30 días para ajustarse a las reglas de las redes de tarjetas. Esa redacción difiere de la ventana de 60 días de la página principal, así que confirma con Recurly qué límite se te aplica antes de basarte en cualquiera de los dos.

Reintentos estáticos

Recurly también documenta una opción sin machine learning, los static retries, basada en los códigos de rechazo de la pasarela y los merchant advice codes. Se detiene tras 7 rechazos de transacción, 20 intentos en total o 60 días desde la creación de la factura, lo que llegue antes, o antes si el ciclo de dunning termina primero.

Uses la lógica que uses, los reintentos nunca duran más que el ciclo de dunning. Si tu ventana de dunning es corta, también limita tus reintentos.

Campañas y ciclos de dunning

Una campaña de dunning es el conjunto de reglas que Recurly aplica a una factura impagada. Cada sitio tiene una campaña por defecto, y en los planes que lo permiten puedes crear campañas adicionales y asignarlas a planes o cuentas concretos. La página de campañas de dunning indica que tener varias campañas requiere un plan Professional o Elite. Las campañas están en Configuration, y luego Dunning Management. Los ajustes de dunning tienen versiones, así que editar una campaña no cambia las facturas que ya están en dunning.

Cada campaña contiene hasta tres tipos de ciclo, cada uno con su calendario y sus correos:

Tipo de ciclo Se aplica a Plantilla de correo por defecto
Payment Declined Facturas de cobro automático que fallan Payment Declined
Invoice Past Due Facturas de cobro manual que superan su plazo de pago Invoice Past Due
Post-Trial Payment Declined Facturas que fallan justo después de una prueba gratis Post-Trial Payment Declined

Para las facturas manuales, el periodo de dunning empieza el día siguiente a que la factura supere su plazo de pago.

¿Cuánto debe durar un ciclo?

La guía de ventanas de dunning de Recurly recomienda:

  • Facturación mensual: una ventana de 27 días, para que el ciclo termine antes de la siguiente factura, incluso en febrero.
  • Facturación trimestral y anual: unos 60 días.
  • Facturación semanal: 7 días.

Son recomendaciones, no límites estrictos. La idea que hay detrás es sensata: si un ciclo mensual dura más de un mes, una segunda factura cae encima de la primera, y ahora persigues dos facturas impagadas de un cliente que quizá nunca vuelva.

Qué pasa al final del ciclo

Para cada ciclo eliges qué pasa con la factura y la suscripción si el cliente no ha pagado. Por defecto Recurly marca la factura como failed. También puedes hacer vencer la suscripción, mantenerla activa o configurar las facturas para que nunca fallen automáticamente, lo que las deja vencidas indefinidamente.

Algunos comportamientos descritos en los artículos de soporte de Recurly que suelen sorprender a los equipos:

  • El estado de la suscripción y el de la factura son independientes. Una suscripción puede estar activa mientras su factura está vencida (artículo de soporte). Basa también las decisiones de acceso en la factura, no solo en la suscripción.
  • Marcar una factura como fallida no cancela la suscripción. Si quieres que la facturación se detenga, cancela la suscripción por separado (artículo de soporte).
  • Cancelar una suscripción no detiene el dunning de las facturas abiertas. Usa Stop Collection en la factura para eso (artículo de soporte).
  • No hay una opción nativa de pausa en la configuración del dunning.

Correos de dunning

Cada paso de un ciclo puede enviar un correo. Recurly incluye plantillas base (Payment Declined, Invoice Past Due, Post-Trial Payment Declined y Subscription Expired for Non-Payment) que no se pueden borrar, y puedes crear las tuyas y asociarlas a los pasos de la campaña.

El correo Payment Declined por defecto ya lleva al cliente a su página de cuenta alojada. Cada cuenta tiene dos URL alojadas: una Account Management URL que inicia la sesión del cliente, y una Edit Billing Information URL que abre solo el formulario de facturación. Si alojas tu propia página de facturación, puedes editar la plantilla para que apunte allí, usando el token de inicio de sesión alojado de la cuenta que da la API.

Un plan de correos sensato para una campaña mensual:

Día Correo Objetivo
0 Pago rechazado Informar, un enlace claro para actualizar la facturación
3 Recordatorio Repetir el enlace, decir lo que pasará después
10 Recordatorio Breve, mencionar que el acceso está en riesgo
20 Último aviso Dar la fecha exacta en que termina la suscripción
Fin Vencida por impago Confirmar el fin, ofrecer una forma de volver

Mantén cada correo breve y centrado en el enlace de facturación. No repitas al cliente el motivo bruto del rechazo.

Actualizar los datos de pago dispara un reintento inmediato

Es uno de los comportamientos nativos más útiles. Según la documentación de Recurly, cuando un cliente actualiza sus datos de facturación, Recurly reintenta el cobro de todas las facturas vencidas de esa cuenta. Esto se aplica también a los rechazos duros: una nueva tarjeta es el único evento que hace que merezca la pena reintentar una factura con rechazo duro. Para el débito directo, cambiar a una nueva cuenta bancaria reinicia el contador de reintentos.

En la práctica, esto significa que tus correos de dunning no necesitan un paso aparte de “pagar ahora”. Llevar al cliente al formulario de facturación es todo el trabajo.

Webhooks que escuchar

La referencia de webhooks de Recurly y la documentación de dunning enumeran los eventos que importan durante el dunning. Cuáles recibes depende de la configuración de tu sitio:

Evento Cuándo se envía Qué hacer en tu app
failed_payment Después de cada pago fallido Marcar la cuenta, mostrar un banner en la app
successful_payment Después de un pago correcto Quitar la marca, restaurar el acceso
new_dunning_event Cuando las facturas entran y siguen en dunning Seguir el estado de dunning por cuenta
charge_invoice.past_due Una factura de cargo pasa a vencida (sitios con facturas de crédito) Iniciar tus propios recordatorios, si los hay
charge_invoice.failed Una factura de cargo falla, directamente o al final del dunning Decidir sobre el acceso, detener los recordatorios
subscription_expired Recurly hace vencer una suscripción, también por impago Quitar el acceso

Los sitios sin facturas de crédito reciben en su lugar las notificaciones de factura antiguas de Recurly, con otros nombres. Comprueba qué conjunto envía tu sitio antes de escribir tus handlers.

Una lista de configuración

  1. Elige tu lógica de reintentos. Intelligent Retries para la mayoría de los negocios con tarjeta; comprueba cómo se reintenta el débito directo si aceptas ACH o SEPA.
  2. Fija la duración del ciclo según la frecuencia de facturación. Parte de las recomendaciones de Recurly de 27 días (mensual) y 60 días (anual).
  3. Elige a propósito la acción de fin de ciclo. Decide si la suscripción vence o sigue activa, y si las facturas fallan. Escríbelo para que el soporte lo sepa.
  4. Escribe los correos. Un enlace por correo, a la página Edit Billing Information o a tu propio formulario de facturación.
  5. Añade una campaña post-prueba si haces pruebas gratis. El primer cargo tras una prueba falla de forma distinta a una renovación: el cliente nunca te ha pagado.
  6. Conecta los webhooks. Basa el acceso en el estado de la factura, no solo en el de la suscripción.
  7. Añade un banner en la app para los clientes conectados con una factura vencida. Los correos se pasan por alto fácilmente; el producto no.
  8. Revisa cada mes. Mira las facturas que fallaron al final del dunning y los códigos de rechazo que hay detrás.

Hacerlo con NoChurn

Los reintentos y el dunning nativos de Recurly son sólidos, y NoChurn no los sustituye: los reintentos, la facturación y el propio cobro se quedan en Recurly. NoChurn se conecta con una clave de API de Recurly, sigue los webhooks de Recurly y añade correos de recuperación escritos por IA que revisas antes de que salgan, con un enlace para que el cliente actualice sus datos de facturación. También cubre lo que el dunning no hace: flujos de cancelación con motivos y ofertas (un cupón, una pausa o un cambio de plan en la suscripción de Recurly) y un botón de cancelación en un clic siempre visible, correos de win-back el día 30, 60 y 90 según el motivo de cancelación, y un score de churn de 0 a 100. Los contracargos vienen de la pasarela que hay detrás de Recurly; con Stripe o Braintree, NoChurn reúne las pruebas y redacta una respuesta para que la revises. Consulta NoChurn + Recurly.

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