PAGOS FALLIDOSZUORA

Cómo recuperar pagos fallidos en Zuora

Cómo cobra y reintenta Zuora los pagos de suscripción: payment runs, reglas de reintento, Configurable Payment Retry, avisos de pagos rechazados y tarjetas.

Publicado el 8 min de lectura

Cómo recuperar pagos fallidos en Zuora

Zuora te da mucho control sobre el cobro de los pagos, lo que también significa muchos ajustes que configurar bien. Los pagos fallidos en Zuora tocan al menos cuatro áreas: las ejecuciones de pagos (payment runs), las reglas de reintento, las notificaciones y la forma en que los clientes actualizan su método de pago. Esta guía recorre cada una y termina con un plan de configuración práctico.

Se basa en la propia documentación de Zuora: Payment runs, Configure payment retry rules, Payment Retry, Configurable Payment Retry, Payment attempts and retry rules, Standard events for Zuora Payments y How do I allow customers to modify their stored payment methods? (todo consultado en noviembre de 2026). Los nombres de los campos pueden variar según la versión de tu tenant, así que compruébalos en tus propios ajustes.

Paso 1: entiende las payment runs

En Zuora, el cobro automático se hace mediante payment runs. Una payment run cobra las facturas abiertas con métodos de pago electrónicos como las tarjetas o ACH. Según la documentación de las payment runs:

  • Una ejecución puede procesar hasta 200.000 facturas.
  • Hay ejecuciones ad hoc, que lanzas a mano, y ejecuciones recurrentes, que se ejecutan con un calendario diario, semanal o mensual.
  • Las ejecuciones solo cobran a las cuentas con auto-pay activado. El auto-pay se configura en cada cuenta de cliente, así que una cuenta sin él nunca será cobrada por una ejecución, y sus facturas simplemente se quedarán abiertas.
  • Cuando un pago está procesando una factura, esta queda bloqueada, y cualquier otro pago sobre ella falla. Zuora recomienda decidir qué facturas se cobran con qué método (payment run, página de pago, API) para que no choquen.

Lo primero que hay que comprobar cuando “Zuora no reintenta” a menudo no son los reintentos en absoluto: es si la cuenta tiene el auto-pay activado y un método de pago electrónico por defecto.

Paso 2: elige tu mecanismo de reintentos

Zuora tiene dos formas de reintentar un pago electrónico fallido. Zuora desaconseja usar las dos a la vez.

Reglas de reintento a nivel de tenant

Las reglas integradas, descritas en Configure payment retry rules, se aplican por defecto al procesamiento de los pagos fallidos cuando el reintento de pagos está activado en tu tenant. Defines:

  • el número máximo de veces consecutivas que se reintenta un método de pago fallido;
  • un intervalo mínimo desde el último intento fallido (por ejemplo, con 8 horas, no se hace ningún reintento automático si el último fallo fue hace menos de 8 horas);
  • un periodo durante el cual no se reintentan los pagos.

Puedes sustituir estos ajustes por método de pago. Estas reglas son sencillas y previsibles, pero se aplican las mismas a todos los rechazos, sea cual sea su motivo.

Configurable Payment Retry (CPR)

Configurable Payment Retry es la opción más flexible de Zuora. Te permite definir la lógica de reintentos por grupo de clientes y por código de respuesta de la pasarela, asignando los códigos a categorías como rechazos duros, medios y blandos. Puntos clave de la documentación:

Ajuste o comportamiento Lo que documenta Zuora
Ventana de reintentos Días desde la entrada en reintento hasta el último intento, 90 días como máximo
Número de intentos 20 como máximo; la payment run hace el primer intento, CPR hace el resto
Smart Retry Un modelo de machine learning opcional que elige los momentos de reintento según las características del suscriptor y de la transacción
Rechazos duros Una opción Stop Retry On Hard Declines termina el ciclo ante un rechazo duro
Momento Los intentos se ejecutan por lotes a la hora en punto, así que los reintentos no pueden ser más frecuentes que cada hora
Métodos de pago Solo pagos con tarjeta, no débito directo como ACH o SEPA
Cambios de reglas Se aplican solo a los intentos futuros; los ciclos terminados no se reinician

Dos comportamientos de las buenas prácticas de CPR son fáciles de pasar por alto:

  • CPR desactiva el auto-pay mientras dura un ciclo de reintentos, para que la payment run normal no vuelva a cobrar la factura. Según la página de ajustes de auto-pay, lo que cambia depende del nivel de reintento: a nivel de factura solo se desactiva el indicador de auto-pay de la factura; a nivel de cuenta se desactiva el auto-pay de la cuenta y solo se vuelve a activar cuando se cobra el pago. Zuora recomienda el reintento a nivel de factura, que mantiene la cuenta apta para las futuras payment runs. Una página de buenas prácticas más antigua describe que los dos indicadores pasan a false, así que comprueba qué nivel usa tu tenant.
  • Para detener los reintentos de inmediato (por ejemplo, el cliente pagó por transferencia bancaria), terminas el ciclo de reintentos manualmente, lo que puedes hacer con las API de CPR.

Si no estás seguro de cómo clasificar un código de respuesta, Zuora sugiere asignarlo como rechazo blando y vigilar los resultados. Zuora también documenta una forma de probar Smart Retry frente a tu lógica actual antes de cambiarlo todo.

Paso 3: avisa al cliente, con notificaciones y callouts

Los reintentos recuperan los rechazos temporales. Las tarjetas caducadas, sustituidas o bloqueadas necesitan al cliente. Los eventos estándar de pagos de Zuora te dan los puntos de enganche:

  • Payment Declined: se dispara cuando la pasarela rechaza un pago electrónico. Un ajuste “Sequence of failed attempt” controla en qué fallo consecutivo se dispara la notificación; se compara con el NumConsecutiveFailures del método de pago y vale 1 por defecto. Los pagos externos no disparan estas notificaciones.
  • Avisos de caducidad de la tarjeta: eventos 15 y 30 días antes de que caduque la tarjeta por defecto (la fecha de caducidad es el último día del mes de caducidad). Te permiten pedir una nueva tarjeta antes de que falle nada.
  • Payment Method Updated: se dispara cuando cambia el método de pago por defecto, que es tu señal para detener los recordatorios.

Cada notificación se puede entregar como correo o como callout, una petición HTTP a tu endpoint, configurada en la definición de la notificación. Usa los callouts para actualizar tu propia app (banner, acceso) y para disparar cualquier mensaje que gestiones fuera de Zuora. Zuora Workflow también puede reaccionar a estos eventos y enviar correos con plantilla o llamar a API externas si prefieres mantener la lógica dentro de Zuora.

Un plan de notificaciones sencillo:

Disparador Mensaje Canal
La tarjeta caduca en 30 días “Tu tarjeta caduca pronto, actualízala aquí” Correo
Primer pago rechazado “Tu pago no se ha completado”, con el enlace de actualización Correo y en la app
Tercer fallo consecutivo Recordatorio con la fecha en que se verá afectado el acceso Correo
Método de pago actualizado Confirmación, sin más recordatorios Correo

Paso 4: deja que el cliente actualice su método de pago

El enlace de actualización de esos correos necesita un destino. Zuora documenta tres formas de cambiar un método de pago guardado en su guía sobre la modificación de los métodos de pago guardados:

  1. La página de método de pago alojada para las tarjetas de crédito, pasando el ID del método de pago existente (pmId) para que el cliente pueda actualizar los datos de la tarjeta. Es el camino que mantiene los datos de la tarjeta fuera de tus servidores; Zuora recomienda Payment Pages 2.0 en lugar de gestionar los datos de tarjeta a través de la API.
  2. La operación REST Update a payment method. La referencia de la API de Zuora recomienda encarecidamente Payment Pages 2.0 en lugar de llamarla directamente, y enviar un número de tarjeta a través de ella pone tus propios sistemas dentro del alcance de PCI.
  3. La interfaz de Zuora, en la sección Electronic Payment Methods de la cuenta del cliente, para los agentes de soporte.

Una vez guardado un nuevo método de pago por defecto, asegúrate de que la factura abierta se cobra realmente, ya sea en la siguiente payment run (comprueba el auto-pay, que CPR puede haber desactivado) o con un pago inmediato. Recuerda el bloqueo de las facturas: no dejes que una página de pago y una payment run cobren la misma factura a la vez.

Una lista de recuperación para Zuora

  1. Revisa el auto-pay en todas las cuentas con suscripciones activas y confirma que existe un método de pago electrónico por defecto.
  2. Elige un solo mecanismo de reintentos: las reglas del tenant por sencillez, CPR para una lógica que tenga en cuenta el rechazo y los grupos de clientes. No los dos.
  3. Asigna los códigos de respuesta en CPR y activa Stop Retry On Hard Declines, para que una tarjeta robada no se reintente durante semanas.
  4. Mantén la ventana de reintentos más corta que el periodo de facturación en los planes mensuales.
  5. Activa los avisos de caducidad de la tarjeta a 30 y 15 días, y mira Payment Method Updater, que pide a los servicios de actualización de Visa, Mastercard y American Express los nuevos datos de la tarjeta antes del día del ciclo de facturación en las pasarelas compatibles.
  6. Configura la notificación Payment Declined con un enlace a una página de pago alojada, más un callout a tu app.
  7. Cobra después de una actualización: confirma que la factura se cobra cuando se guarda una nueva tarjeta.
  8. Revisa los rechazos cada mes por código de respuesta y grupo de clientes.

Hacerlo con NoChurn

Zuora sigue a cargo de la facturación, las payment runs, los reintentos y tu pasarela. NoChurn se conecta mediante un cliente OAuth de Zuora, importa las cuentas y las suscripciones, recibe las notificaciones de Zuora y añade correos de recuperación escritos por IA que revisas antes de que salgan, con un enlace para actualizar el método de pago. También añade flujos de cancelación con motivos, ofertas (un descuento o un cambio de plan en la suscripción de Zuora) y una 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. Las disputas vienen de la pasarela que hay detrás de Zuora; con Stripe o Braintree, NoChurn reúne las pruebas y redacta una respuesta para que la revises. Consulta NoChurn + Zuora.

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