Cómo reducir el churn de suscripciones en Polar
Cómo gestiona Polar la cancelación al final del periodo frente a la revocación, los reintentos, el portal del cliente, los descuentos, motivos y webhooks.

Polar te da más herramientas contra el churn de lo que cabría esperar de una plataforma de facturación joven: cancelación al final del periodo que el cliente puede deshacer, motivos de cancelación registrados, una opción de pausa y reintentos automáticos de las renovaciones fallidas. Esta guía explica cómo funciona cada pieza y cómo añadir encima un paso de retención y el win-back.
Se limita a la documentación de Polar: gestionar suscripciones, recuperar pagos fallidos, portal del cliente, descuentos, modificar una suscripción, eventos de webhook, analytics, comisiones y el changelog (todos consultados en noviembre de 2026). La documentación de Polar cambia rápido, así que comprueba la versión de la API que usas.
Polar es el merchant of record
Polar vende a tus clientes como merchant of record y se encarga de los impuestos, los pagos y las disputas. Su página de comisiones dice que cada disputa cuesta 15 $, se gane o se pierda, descontados de tu saldo. Su página de revisión de cuentas explica que Polar vigila las tasas de contracargo y, para pedidos por debajo de cierto valor, puede reembolsar automáticamente cuando recibe una señal temprana de las redes de tarjetas. No respondes tú a las disputas, pero la forma en que gestionas las cancelaciones influye directamente en cuántas recibes.
Dos formas de terminar una suscripción
La página de gestión de suscripciones de Polar describe dos vías.
| Cancelar al final del periodo | Revocar | |
|---|---|---|
| Cómo | PATCH /v1/subscriptions/{id} con cancel_at_period_end: true, o el interruptor del panel |
DELETE /v1/subscriptions/{id} |
| Acceso | Se mantiene hasta current_period_end |
Termina de inmediato, beneficios revocados |
| Reembolso | No aplica | No se emite ninguno |
| Reversible | Sí, hasta la fecha de fin (uncancel) | No |
Para un cliente que pide cancelar, cancelar al final del periodo es la opción correcta por defecto: conserva lo que pagó y puede cambiar de opinión. Polar lo dice él mismo: usa la cancelación al final del periodo si quieres poder revertir la decisión. Deshacer la cancelación vuelve a poner cancel_at_period_end en false y vacía ends_at y canceled_at.
Registra el motivo
Cuando cancelas al final del periodo mediante la API, Polar acepta un motivo y un comentario opcionales. Los ocho códigos de motivo son too_expensive, missing_features, switched_service, unused, customer_service, low_quality, too_complex y other. Polar te pide que los fijes solo cuando el cliente los dio de verdad, por ejemplo en una encuesta, y advierte de que el comentario es visible para el cliente en su historial de compras, así que las notas internas no van ahí.
Los analytics de Polar muestran los motivos de cancelación en gráficos en los que puedes hacer clic para ver las suscripciones y los comentarios que hay detrás. También separan “canceled” (el cliente pidió cancelar durante el periodo) de “churned” (el acceso de pago terminó de verdad), una distinción útil cuando mides un flujo de cancelación.
Pausa
Según el changelog de Polar, una pausa se programa para el final del periodo de facturación. En ese momento se detiene la facturación y se revocan los beneficios, pero la suscripción y el método de pago se conservan. Puedes dejar que los clientes pausen desde el portal del cliente, y los webhooks subscription.paused y subscription.resumed te dicen cuándo cambia el estado.
El portal del cliente
El portal del cliente alojado de Polar permite a los clientes cancelar (al final del periodo por defecto) y actualizar su método de pago por defecto. Los cambios de plan, los cambios de puestos y la pausa o la reanudación dependen de interruptores en los ajustes de tu portal. La actualización del método de pago solo está disponible en el portal alojado, lo que mantiene los datos de tarjeta fuera de tus servidores; la Customer Portal API que puedes usar para tu propio portal no la cubre.
Si los clientes cancelan desde el portal alojado, van directamente a la cancelación. Si quieres antes un paso de retención, envía el botón “Cancelar” de tu app a tu propio flujo, y reserva el portal alojado para los datos de pago.
Descuentos
Los descuentos de Polar se aplican una vez, durante un número fijo de meses o para siempre. Para dar un descuento a un suscriptor existente, fija discount_id con el endpoint update subscription; Polar aplica el cambio en el siguiente ciclo de facturación, y null lo quita. La documentación de Polar no dice si cambiar un descuento recurrente reinicia los meses que le quedan, así que pruébalo en el sandbox antes de contar con ello.
Qué hace Polar con los pagos fallidos
Polar documenta su comportamiento en recuperar pagos fallidos:
- Cuando falla el cobro de una renovación, la suscripción pasa a
past_duey se disparasubscription.past_due. - Polar reintenta cuatro veces: 2, 5, 7 y 7 días después del intento anterior, es decir, 2, 7, 14 y 21 días después del primer fallo.
- Si el cliente actualiza su método de pago en el portal, Polar reintenta el cobro de inmediato.
- Si todos los reintentos fallan, o el rechazo significa que el método de pago nunca funcionará, Polar deja de reintentar, la suscripción termina, los beneficios se revocan y se dispara
subscription.revoked. - Un periodo de gracia a nivel de organización puede retrasar la revocación de los beneficios. No cambia el calendario de reintentos.
Los pedidos de los contadores de uso siguen otro calendario y no afectan a la suscripción en sí; consulta la página de facturación de Polar. El momento de los reintentos lo fija Polar; lo que puedes añadir es una comunicación clara con el cliente mientras la suscripción está vencida, que le lleve al portal para actualizar su tarjeta.
Webhooks que escuchar
De los eventos de webhook de Polar:
| Evento | Significado |
|---|---|
subscription.updated |
Se dispara con cada cambio, incluidos los de abajo |
subscription.canceled |
Cancelación solicitada; la suscripción puede seguir activa hasta el final del periodo |
subscription.uncanceled |
El cliente deshizo una cancelación pendiente |
subscription.revoked |
El acceso termina: se llegó al final del periodo tras la cancelación, o se agotaron los reintentos |
subscription.past_due |
Falló un pago de renovación y todavía puede recuperarse |
subscription.paused / subscription.resumed |
Cambió el estado de pausa |
subscription.cycled |
Una renovación |
En una cancelación al final del periodo, Polar envía subscription.updated y subscription.canceled de inmediato (estado aún active, cancel_at_period_end en true), y después subscription.updated y subscription.revoked cuando termina el periodo. La indicación de Polar es no quitar el acceso con subscription.canceled, sino esperar al final del periodo o a subscription.revoked.
Un flujo de cancelación en Polar, paso a paso
- Dirige el “Cancelar” de tu app a tu flujo, no a una llamada inmediata a la API.
- Pregunta por qué, con los ocho códigos de motivo de Polar para que las respuestas cuadren con los analytics de Polar, más un campo de texto libre.
- Muestra una oferta que encaje con el motivo.
too_expensive: un descuento durante unos meses.unused: una pausa.missing_featuresotoo_complex: una respuesta de una persona. - Mantén “Cancelar ahora” visible en cada paso, terminando en un clic.
- Aplica el resultado. Descuento:
PATCHcondiscount_id. Cancelación:PATCHconcancel_at_period_end: true, el motivo y, si el cliente escribió uno, el comentario. Evita revocar salvo que el cliente pidiera un final inmediato, ya que no se puede deshacer y no emite ningún reembolso. - Confirma la fecha de fin a partir de
current_period_end, y ofrece un botón “mantener mi suscripción” hasta entonces.
Win-back
Parte de subscription.revoked. Guarda el motivo que dio el cliente, espera y después contáctale con algo que responda a ese motivo, y envíale a un checkout nuevo, con un descuento si encaja.
Hacerlo con NoChurn
NoChurn lee tus suscripciones y webhooks de Polar y añade un flujo de cancelación con motivos, ofertas y una cancelación en un clic siempre visible, alojado o headless mediante la API, además de correos de win-back los días 30, 60 y 90 según el motivo de cancelación y un churn score de 0 a 100. Polar sigue siendo el merchant of record: el checkout, los pagos, la recuperación de pagos, los reembolsos y las disputas siguen en Polar, y las disputas aparecen en NoChurn en solo lectura. NoChurn es gratis por debajo de 300 € de MRR, con todas las funciones en todos los planes (tu propio dominio para correos y páginas alojadas como complemento de 14,99 € al mes en cualquier plan). Consulta NoChurn + Polar.