Qué pasa cuando falla un pago en Polar
Qué hace Polar cuando falla una renovación: estado past_due, el calendario fijo de reintentos, el periodo de gracia, la revocación, webhooks y qué añadir.

Polar vende tus suscripciones como merchant of record. Cuando falla la renovación de una suscripción, Polar gestiona la recuperación por su cuenta: reintenta la tarjeta, mantiene la suscripción en un estado recuperable y revoca los beneficios si nada funciona. Las reglas son sencillas y en su mayoría fijas, lo que conviene saber antes de diseñar nada en torno a ellas.
Esta guía explica la secuencia paso a paso, el único ajuste que controlas, los webhooks que escuchar y lo que puedes añadir sin pelearte con el propio flujo de Polar. Se limita a la documentación de Polar: recuperar pagos fallidos, cómo funcionan las suscripciones, y los webhooks subscription.past_due y subscription.revoked (todos consultados en noviembre de 2026). Cuando las páginas de Polar no coinciden o no dicen nada, lo indicamos.
La secuencia, paso a paso
Según la página de pagos fallidos de Polar:
- En la renovación, Polar avanza primero la suscripción al siguiente ciclo de facturación y después intenta cobrar el método de pago por defecto del cliente.
- Si el cobro falla, la suscripción no se cancela. Pasa a
past_duey entra en la recuperación automática de pagos de Polar. - Polar reintenta el pago según un calendario fijo: cuatro intentos repartidos en 21 días, contados desde el primer fallo. El calendario lo fija Polar y no se puede configurar.
- Si el cliente actualiza su método de pago mientras tanto, Polar reintenta el cobro de inmediato en lugar de esperar al siguiente intento programado.
- Si un reintento funciona, la suscripción vuelve a estar al día.
- Si todos los reintentos fallan, o si el código de rechazo muestra que el método de pago nunca funcionará (Polar da
lost_cardcomo ejemplo), Polar deja de reintentar y revoca la suscripción y sus beneficios.
Vale la pena fijarse en el punto 6. Polar no sigue reintentando una tarjeta que no puede funcionar, que es el comportamiento correcto, y eso significa que los rechazos definitivos terminan mucho antes de los 21 días salvo que el cliente actúe.
El ajuste que controlas: el periodo de gracia
Por defecto, Polar revoca los beneficios de forma estricta. Polar ofrece un periodo de gracia a nivel de organización que aplaza la revocación de los beneficios mientras una suscripción está en past_due. Lo fijas en Settings, después Subscriptions, después “Grace period for benefit revocation”.
Lo que hace y lo que no hace el periodo de gracia, según la documentación de Polar:
| Durante el periodo de gracia | |
|---|---|
| Estado de la suscripción | Sigue en past_due |
| Beneficios del cliente | Se conservan |
| Calendario de reintentos | Sin cambios |
| Se mide desde | past_due_at |
Así que el periodo de gracia tiene que ver con el acceso, no con el cobro. Es una buena opción cuando los beneficios son cosas de las que los clientes dependen a diario (una clave de licencia, el acceso a un repositorio privado, un rol de Discord), y perderlos por un problema temporal de tarjeta haría que el cliente se fuera para siempre.
Cómo lo arregla el cliente
La solución para la mayoría de los rechazos definitivos es una tarjeta nueva. El resumen de las suscripciones de Polar dice que el Customer Portal permite a los clientes actualizar su método de pago, descargar facturas y cancelar. Como Polar reintenta justo después de una actualización del método de pago, un cliente que actualiza su tarjeta recupera la suscripción enseguida.
La documentación de Polar que revisamos no detalla el contenido ni el momento de las notificaciones por correo que se envían a los clientes en caso de fallo. Pruébalo en sandbox: provoca un fallo con una tarjeta de prueba y mira qué llega a la bandeja del cliente antes de escribir tus propios mensajes, para no enviar duplicados.
Los webhooks que escuchar
| Evento | Significado |
|---|---|
subscription.past_due |
Falló una renovación. Polar lo describe como un estado recuperable: el cliente puede actualizar su método de pago para restablecer la suscripción. |
subscription.updated |
La suscripción cambió, también cuando se recupera |
subscription.revoked |
La suscripción se revocó, porque se canceló o porque se agotaron los reintentos de pago |
Una incoherencia que hay que tener en cuenta: la página de subscription.revoked de Polar dice que cuando se agotan los reintentos de pago el estado pasa a unpaid, mientras que la página de pagos fallidos describe que la suscripción termina como cancelada con los beneficios revocados. Escribe tu handler para tratar ambos casos como “ya no paga”, y registra el estado que recibes realmente.
Una configuración práctica en Polar
- Decide el periodo de gracia. Si los beneficios forman parte del trabajo diario, fija uno. Si los beneficios son fáciles de restaurar, la revocación estricta está bien.
- Gestiona
subscription.past_dueen tu app. Muestra un banner con un enlace al Customer Portal. Muchos clientes nunca leen los correos de facturación, pero sí ven tu producto. - Explica lo que pasa después. Dile al cliente que Polar lo volverá a intentar y que actualizar la tarjeta lo arregla al instante.
- Gestiona la revocación con cuidado. Con
subscription.revoked, conserva los datos del cliente, explica por qué se cortó el acceso y da una vía clara de vuelta. - Registra cada fallo. Guarda la suscripción, el importe, la fecha y el resultado. Tras unos meses verás cuántos se recuperan con un reintento y cuántos solo tras actualizar la tarjeta.
- Prueba con tarjetas de sandbox. Haz un rechazo temporal, un rechazo definitivo y una recuperación antes de pasar a producción.
Cómo es la cronología para un cliente
Juntando las reglas de Polar, un rechazo temporal típico se desarrolla así:
- Día de la renovación: el cobro falla, la suscripción pasa a
past_dueysubscription.past_duellega a tu app. - Durante las tres semanas siguientes: Polar hace sus reintentos programados. Si fijaste un periodo de gracia, el cliente conserva sus beneficios durante ese tiempo.
- En cualquier momento de esa ventana: el cliente actualiza su tarjeta en el Customer Portal, Polar reintenta enseguida y la suscripción se recupera.
- Final de la ventana sin éxito: Polar revoca la suscripción y
subscription.revokedllega a tu app.
En un rechazo definitivo, el paso 2 puede saltarse por completo, porque Polar deja de reintentar un método de pago que no puede funcionar. Por eso el banner en la app importa sobre todo en los rechazos definitivos: la acción del propio cliente es la única vía de vuelta, y la ventana es corta.
Lo que Polar no cubre
La recuperación de Polar es sencilla a propósito. Lo que te queda a ti:
- El contexto. Polar trata todos los fallos de la misma forma. Un fallo de un cliente de hace tiempo que usa el producto a diario merece un mensaje distinto que uno de una cuenta dormida.
- Mensajes con tu propio tono. Si quieres mensajes de recuperación que mencionen el plan, el uso o el equipo del cliente, los escribes tú.
- La medición. Recuperado frente a perdido cada mes, por causa. Consulta churn involuntario para las definiciones y plantillas de correos de recuperación para ideas de mensajes.
- La prevención. Las tarjetas que caducan antes de la próxima renovación son previsibles. Un recordatorio antes de la renovación evita el fallo por completo; consulta tarjetas que caducan.
Hacerlo con NoChurn
En Polar, el cobro, los reintentos y el calendario de 21 días siguen en manos de Polar como merchant of record; NoChurn no los cambia. Lee tus suscripciones y fallos de Polar, envía correos de recuperación escritos por IA que revisas antes de que salgan y da a cada cliente un churn score de 0 a 100, enriquecido con tus propios datos enviados por API. Las cancelaciones pasan después por un flujo de cancelación y por correos de win-back los días 30, 60 y 90. Consulta NoChurn + Polar.